Configure enterprise logins

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:

  1. 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.

  2. Run the Windows PowerShell command line as a system administrator to run the Install-Module cmdlet.
    Install-Module -Name Microsoft.Graph
  3. Run the following cmdlet to install the ArcGIS.Microsoft365 module:
    Install-Module -Name ArcGIS.Microsoft365
    See ArcGIS for Microsoft 365 PowerShell cmdlet information.
  4. 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:

  • 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"

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.