作为组织管理员,您可以为企业组织成员配置 ArcGIS 连接的列表。
可以使用包含 URL 字符串和标题的 PowerShell 函数配置一个或多个 ArcGISConnectionInfo 连接。 获得许可的组织成员在登录时将使用这些连接。 URL 字符串可确定用户在使用与 ArcGIS 集成的 Microsoft 365 产品创建地图时连接到的 ArcGIS Online 或 ArcGIS Enterprise 实例。
组织成员可以通过在 ArcGIS 登录提示处从连接列表中选择一个连接来确定 ArcGIS 连接。 有关详细信息,请参阅登录到 ArcGIS 帐户。
设置是由租户管理员执行的一次性过程。 所有与 ArcGISConnectionInfo 相关的 PowerShell 函数均使用 Microsoft.Graph 模块。
安装和配置企业连接
要安装和配置企业连接,请完成以下步骤:
- 确保已安装 Microsoft.Graph 模块。
Microsoft.Graph 模块用于调用 MSGraph API,以配置组织级开放扩展模块。 有关此模块的详细信息,请参阅 Microsoft 安装 Microsoft Graph PowerShell SDK 文章。
- 以系统管理员身份运行以下 Windows PowerShell 命令行,以运行 Install-Module cmdlet:
Install-Module -Name Microsoft.Graph
- 运行以下 cmdlet 以安装 ArcGIS.Microsoft365 模块:
Install-Module -Name ArcGIS.Microsoft365
- 运行以下 cmdlet 以将模块添加到当前会话:
Import-Module .\ArcGIS.Microsoft365.psm1 -Force
- 运行以下 cmdlet 以允许远程登录的 PowerShell cmdlet 和函数:
Set-ExecutionPolicy RemoteSigned
管理 ArcGIS 连接
租户管理员将管理组织成员用于登录到 ArcGIS for Microsoft 365 产品的连接。
在使用 ArcGIS.Microsoft365 PowerShell 模块函数之前,请先在包含以下 cmdlet 的 PowerShell 命令行会话中登录到 Microsoft Azure:Connect-MgGraph -Scopes "Organization.ReadWrite.All"
登录到 Microsoft Azure 后,租户管理员可以为组织管理员配置一个 ArcGIS 连接列表。 当用户使用与 ArcGIS 集成的 Microsoft 365 产品登录时,此列表将显示为下拉菜单。
租户管理员可以使用 PowerShell 创建、编辑、移除、清除、显示或导出配置的 ArcGISConnectionInfo 连接。 下表将列出可用的 PowerShell 函数:
设置新的 ArcGIS 连接
函数 | 必填/可选 | 描述 |
---|---|---|
命令:New-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default] | ||
-ArcGISConnectionUrl | 必填 | 为新连接设置 URL 路径。 |
-ArcGISConnectionTitle | 必填 | 为新连接设置标题。 |
-Default | 可选 | 将此连接设置为默认连接(登录时将首先显示)。 |
例如:
|
设置 ArcGIS Online 连接许可
函数 | 必填/可选 | 描述 |
---|---|---|
命令:Set-ArcGISOnlineConnectionPermission [- allow] [- disallow] | ||
-ArcGISOnlineConnecionPermission | 必填 | 指定用户是否可以连接到 ArcGIS Online。 |
-allow 或 -disallow | 需要其中一个函数。 | 此函数可允许或禁止用户连接到非租户管理员设置的 ArcGIS Online 组织。 |
设置自定义 URL 连接许可
函数 | 必填/可选 | 描述 |
---|---|---|
命令:Set-CustomURLConnectionPermission [- allow] [- disallow] | ||
-CustomURLConnectionPermission | 必填 | 请指定用户是否可以使用自定义 URL 连接。 |
-allow 或 -disallow | 需要其中一个函数。 | 此函数可允许或禁止用户手动输入自定义 Enterprise 连接。 如果禁止,则可确保用户仅可访问租户管理员设置的 URL。 |
更新连接信息
函数 | 必填/可选 | 描述 |
---|---|---|
命令:Update-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default] | ||
-ArcGISConnectionUrl | 必填 | 为此连接指定现有 URL 路径。 警告:URL 必须与现有连接匹配,否则此命令将运行失败。 |
-ArcGISConnectionTitle | 必填 | 指定要为此连接使用或更新的新标题。 |
-Default | 可选 | 将此连接设置为默认连接(登录时将首先显示)。 |
示例:Update-ArcGISConnection -ArcGISConnectionUrl "https://xxx.maps.arcgis.com" -ArcGISConnectionTitle "My org 2022" -Default |
显示现有连接
命令 | 描述 | |
---|---|---|
Show-ArcGISConnections | 显示 PowerShell 中的所有可用连接。 |
移除连接
函数 | 必填/可选 | 描述 |
---|---|---|
命令:Remove-ArcGISConnection ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] | ||
-ArcGISConnectionTitle | 必填 | 指定要从现有连接中移除的单个连接。 |
示例:Remove-ArcGISConnection -ArcGISConnectionTitle "My org 2022" |
清除 ArcGIS 连接
命令 | 描述 | |
---|---|---|
Clear-AllTenantArcGISConnections | 移除租户管理员设置的所有已添加的 ArcGIS Online 和 ArcGIS Enterprise 连接字符串。 |
重置所有 ArcGIS 连接设置
命令 | 描述 | |
---|---|---|
Reset-TenantArcGISSettings | 重置所有设置并将连接设置恢复为默认值。 如果您之前禁止了 ArcGIS Online 或自定义 ArcGIS 连接,则这些设置将恢复为允许这些连接的默认设置。 |
导出连接
命令 | 描述 | |
---|---|---|
Export-ArcGISConnections | 将所有连接导出到本地 .txt 文件。 |