Configurar inicios de sesión corporativos

Como administrador de la organización, puede configurar una lista de conexiones a ArcGIS para los miembros de su organización empresarial.

Puede configurar una o más conexiones de ArcGISConnectionInfo utilizando funciones de PowerShell que contengan una cadena de caracteres de URL y un título. Las utilizan los miembros de organización con licencia al iniciar sesión. La cadena de caracteres de URL determina la instancia de ArcGIS Online o ArcGIS Enterprise a la que se conecta un usuario cuando crea un mapa utilizando un producto de Microsoft 365 integrado con ArcGIS.

Los miembros de la organización pueden determinar la conexión de ArcGIS seleccionando una de una lista de conexiones en la ventana de inicio de sesión de ArcGIS. Consulte Iniciar sesión en una cuenta de ArcGIS para obtener más información.

La configuración es un proceso único que realiza el administrador de inquilinos. Todas las funciones de PowerShell relacionadas con ArcGISConnectionInfo utilizan el módulo Microsoft.Graph.

Instalar y configurar conexiones corporativas

Para instalar y configurar conexiones corporativas, siga estos pasos:

  1. Asegúrese de que el módulo Microsoft.Graph esté instalado.

    El módulo Microsoft.Graph se utiliza para llamar a la API de MSGraph para configurar extensiones abiertas a nivel de organización. Consulte el artículo de Microsoft Instalar Microsoft Graph PowerShell SDK para obtener más información acerca de este módulo.

  2. Ejecute la siguiente línea de comandos de Windows PowerShell como administrador del sistema para ejecutar el cmdlet Install-Module:
    Install-Module -Name Microsoft.Graph
  3. Ejecute el siguiente cmdlet para instalar el módulo ArcGIS.Microsoft365:
    Install-Module -Name ArcGIS.Microsoft365
  4. Ejecute el siguiente cmdlet para agregar el módulo a la sesión actual:
    Import-Module .\ArcGIS.Microsoft365.psm1 -Force
  5. Ejecute el siguiente cmdlet para permitir los cmdlets y funciones de PowerShell firmados remotamente:
    Set-ExecutionPolicy RemoteSigned

Administrar conexiones de ArcGIS

Los administradores de inquilinos administran las conexiones utilizadas por los miembros de la organización para iniciar sesión en los productos de ArcGIS for Microsoft 365.

Inicie sesión en Microsoft Azure en la sesión de línea de comandos de PowerShell con el siguiente cmdlet antes de utilizar las funciones del módulo ArcGIS.Microsoft365 PowerShell:

Connect-MgGraph -Scopes "Organization.ReadWrite.All"

Una vez que hayan iniciado sesión en Microsoft Azure, los administradores de inquilinos pueden configurar una lista de conexiones de ArcGIS para los miembros de la organización. Esta lista se muestra como un menú desplegable cuando los usuarios inician sesión utilizando un producto de Microsoft 365 integrado con ArcGIS.

El administrador de inquilinos puede utilizar PowerShell para crear, editar, eliminar, borrar, mostrar o exportar conexiones de ArcGISConnectionInfo configuradas. En las tablas siguientes se enumeran las funciones disponibles en PowerShell:

Establecer una nueva conexión de ArcGIS

FunciónObligatorio/opcionalDescripción

Comando: New-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default]

-ArcGISConnectionUrl

Requerido

Defina la ruta de URL de la nueva conexión.

-ArcGISConnectionTitle

Requerido

Defina un título para la nueva conexión.

-Default

Opcional

Establecer esta conexión como predeterminada (se muestra primero en el inicio de sesión).

Ejemplos:

  • New-ArcGISConnection -ArcGISConnectionUrl "https://xxx.maps.arcgis.com" -ArcGISConnectionTitle "My org 2021" -Default
  • New-ArcGISConnection -ArcGISConnectionUrl "https://xxx.maps.arcgis.com" -ArcGISConnectionTitle "Group account 2021"

Configurar permiso de conexión de ArcGIS Online

FunciónObligatorio/opcionalDescripción

Comando: Set-ArcGISOnlineConnectionPermission [- allow] [- disallow]

-ArcGISOnlineConnecionPermission

Requerido

Especifique si el usuario puede conectarse a ArcGIS Online.

-allow o -disallow

Se requiere una de las funciones.

Esta función permite o impide que el usuario se conecte a una organización de ArcGIS Online que no ha configurado el administrador de inquilinos.

Configurar permisos de conexión URL personalizada

FunciónObligatorio/opcionalDescripción

Comando: Set-CustomURLConnectionPermission [- allow] [- disallow]

-CustomURLConnectionPermission

Requerido

Especifique si el usuario puede utilizar conexiones URL personalizadas.

-allow o -disallow

Se requiere una de las funciones.

Esta función permite o impide que el usuario introduzca conexiones Enterprise personalizadas de forma manual. Cuando se desactiva, el usuario solo puede acceder a las URL configuradas por el administrador de inquilinos.

Actualizar información de conexión

FunciónObligatorio/opcionalDescripción

Comando: Update-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default]

-ArcGISConnectionUrl

Requerido

Especificar una ruta de URL existente para esta conexión.

Precaución:

La dirección URL debe coincidir con una conexión existente o este comando fallará.

-ArcGISConnectionTitle

Requerido

Especifique el nuevo título que desea utilizar o actualícelo para esta conexión.

-Default

Opcional

Establecer esta conexión como predeterminada (se muestra primero en el inicio de sesión).

Ejemplo: Update-ArcGISConnection -ArcGISConnectionUrl "https://xxx.maps.arcgis.com" -ArcGISConnectionTitle "My org 2022" -Default

Mostrar conexiones existentes

ComandoDescripción

Show-ArcGISConnections

Muestre todas las conexiones disponibles en PowerShell.

Eliminar una conexión

FunciónObligatorio/opcionalDescripción

Comando: Remove-ArcGISConnection ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE]

-ArcGISConnectionTitle

Requerido

Especificar una sola conexión para quitarla de las conexiones existentes.

Ejemplo: Remove-ArcGISConnection -ArcGISConnectionTitle "My org 2022"

Borrar conexión de ArcGIS

ComandoDescripción

Clear-AllTenantArcGISConnections

Elimine todas las cadenas de conexión de ArcGIS Online y ArcGIS Enterprise que ha configurado el administrador de inquilinos.

Restablecer toda la configuración de conexión de ArcGIS

ComandoDescripción

Reset-TenantArcGISSettings

Restablezca toda la configuración y restaure la configuración de conexión en los valores predeterminados. Si antes ha deshabilitado las conexiones de ArcGIS personalizadas o ArcGIS Online, esta configuración recupera los valores predeterminados para permitir estas conexiones.

Exportar conexiones

ComandoDescripción

Export-ArcGISConnections

Exporte todas las conexiones a un archivo .txt local.