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:
- 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.
- 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
- Ejecute el siguiente cmdlet para instalar el módulo ArcGIS.Microsoft365:
Install-Module -Name ArcGIS.Microsoft365
- Ejecute el siguiente cmdlet para agregar el módulo a la sesión actual:
Import-Module .\ArcGIS.Microsoft365.psm1 -Force
- 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ón | Obligatorio/opcional | Descripció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:
|
Configurar permiso de conexión de ArcGIS Online
Función | Obligatorio/opcional | Descripció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ón | Obligatorio/opcional | Descripció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ón | Obligatorio/opcional | Descripció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
Comando | Descripción | |
---|---|---|
Show-ArcGISConnections | Muestre todas las conexiones disponibles en PowerShell. |
Eliminar una conexión
Función | Obligatorio/opcional | Descripció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
Comando | Descripció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
Comando | Descripció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
Comando | Descripción | |
---|---|---|
Export-ArcGISConnections | Exporte todas las conexiones a un archivo .txt local. |