You can specify your ArcGIS organization's subdomain to enable enterprise logins across your SharePoint site collection. Configuring enterprise logins allows members of your organization to sign in to ArcGIS for SharePoint using the same credentials they use to access your enterprise information systems. The advantage of setting up enterprise logins is that members do not need to create additional logins within ArcGIS; instead, they can use the account that is already set up within their enterprise system.
To configure enterprise logins, type the subdomain of your ArcGIS Online organization in the URL field on the app's configuration page. For detailed instructions, see Configure ArcGIS for SharePoint.
Configure enterprise ArcGIS connection
Organization administrators can pre-configure a list of connections to ArcGIS for enterprise organization members who are map authors.
Administrators can configure one or more ArcGISConnectionInfo using PowerShell functions that contain a URL string and a title. These are used by map author organization members during sign in. The URL string determines the ArcGIS Online or ArcGIS Enterprise instance to which a map author organization member is connected when they create a map in any Microsoft 365 product integrated with ArcGIS.
Map authors will choose from a pre-configured list of ArcGIS connections when they create a map and see an ArcGIS sign-in prompt. See Sign in with a pre-configured ArcGIS account.
Set up is a one-time process, performed by the tenant administrator. All ArcGISConnection related PowerShell functions depend on the Microsoft.Graph module.
Install and configure
To install and configure enterprise connections for map author organization members, complete the following steps:
- Ensure that you have the Microsoft.Graph module installed.
Microsoft.Graph is used to call MSGraph API to configure organization-level open extensions. See Install the Microsoft Graph PowerShell SDK for more information about this module.
- Run the Windows PowerShell command
line as a system administrator to run the Install-Module cmdlet.
Install-Module -Name Microsoft.Graph - Run the following cmdlet to install the ArcGIS.Microsoft365 module:
Install-Module -Name ArcGIS.Microsoft365 - Run the following cmdlet to allow remote signed PowerShell cmdlets and functions:
Set-ExecutionPolicy RemoteSigned
Administer ArcGIS connections
Tenant administrators are responsible to administer the connections used by map author organization members to sign in to any ArcGIS for Microsoft 365 product.
Sign in to Azure in the PowerShell command line session with the following cmdlet before using any ArcGIS.Microsoft365 PowerShell module functions:Connect-MgGraph -Scopes "Organization.Read.All"
Once signed in to Microsoft Azure, tenant administrators can configure a list of ArcGIS connections for map author organization members. This list is shown as a drop-down to map authors when they create a map using any Microsoft 365 product integrated with ArcGIS.
The tenant administrator can use the PowerShell to create, edit, remove, clear, display, or export configured ArcGISConnectionInfo. The following examples demonstrate the available PowerShell functions:
| Set new ArcGISConnectionInfo | ||
|---|---|---|
Command: New-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default] | ||
-ArcGISConnectionUrl | Required | Sets the new URL path for this connection. |
-ArcGISConnectionTitle | Required | Sets a new Title for this connection. |
-Default | Optional | If specified, sets this connection as the default (shown first to the map author). |
Example:
| ||
| Update ArcGISConnectionInfo | ||
|---|---|---|
Command: Update-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default] | ||
-ArcGISConnectionUrl | Required | Specifies an existing URL path for this connection. Caution:URL must match an existing connection, or this command will fail. |
-ArcGISConnectionTitle | Required | Specifies the Title to use or update for this connection. |
-Default | Optional | If specified, sets this connection as the default (shown first to the map author). |
Example: Update-ArcGISConnection -ArcGISConnectionUrl "https://xxx.maps.arcgis.com" -ArcGISConnectionTitle "My org 2022" -Default | ||
| Remove ArcGISConnection | ||
|---|---|---|
Command: Remove-ArcGISConnection ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] | ||
-ArcGISConnectionTitle | Required | Specifies a single connection to remove from the existing connections. |
Example: Remove-ArcGISConnection -ArcGISConnectionTitle "My org 2022" | ||
| Show ArcGISConnections | ||
|---|---|---|
Command: Show-ArcGISConnections | ||
Displays all available ArcGISConnectionInfo in the PowerShell. |
| Clear ArcGISConnections | ||
|---|---|---|
Command: Clear-ArcGISConnections | ||
Removes all ArcGISConnectionInfo; all connections are removed. |
| Export ArcGISConnections | ||
|---|---|---|
Command: Export-ArcGISConnections | ||
Exports all ArcGISConnectionInfo to a local text (.txt) file. |