Als Organisationsadministrator können Sie eine Liste der Verbindungen mit ArcGIS für Mitglieder Ihrer Enterprise-Organisation konfigurieren.
Mit PowerShell-Funktionen können Sie ArcGISConnectionInfo-Verbindungen konfigurieren, die eine URL-Zeichenfolge und einen Titel enthalten. Diese werden durch lizenzierte Organisationsmitglieder beim Anmelden verwendet. Die URL-Zeichenfolge bestimmt die ArcGIS Online- oder ArcGIS Enterprise-Instanz, mit der ein Benutzer verbunden wird, wenn er mit einem Microsoft 365-Produkt, das in ArcGIS integriert ist, eine Karte erstellt.
Organisationsmitglieder können die ArcGIS-Verbindung bestimmen, indem sie sie bei der ArcGIS-Anmeldung in einer Liste der Verbindungen auswählen. Weitere Informationen finden Sie unter Anmelden bei einem ArcGIS-Konto.
Die Einrichtung wird einmalig vom Mandantenadministrator durchgeführt. Alle ArcGISConnectionInfo-bezogenen PowerShell-Funktionen verwenden das Microsoft.Graph-Modul.
Installieren und Konfigurieren von Enterprise-Verbindungen
Führen Sie die folgenden Schritte aus, um Enterprise-Verbindungen zu installieren und zu konfigurieren:
- Stellen Sie sicher, dass das Microsoft.Graph-Modul installiert ist.
Das Modul Microsoft.Graph wird verwendet, um die MSGraph-API aufzurufen und offene Erweiterungen auf Organisationsebene zu konfigurieren. Weitere Informationen zu diesem Modul finden Sie imMicrosoft-Artikel Install the Microsoft Graph PowerShell SDK.
- Führen Sie die folgende Windows PowerShell-Befehlszeile als Systemadministrator aus, um das Cmdlet "Install-Module" auszuführen.
Install-Module -Name Microsoft.Graph - Führen Sie das folgende Cmdlet aus, um das ArcGIS.Microsoft365-Modul zu installieren:
Install-Module -Name ArcGIS.Microsoft365 - Führen Sie das folgende Cmdlet aus, um das Modul zur aktuellen Sitzung hinzuzufügen:
Import-Module .\ArcGIS.Microsoft365.psm1 -Force - Führen Sie das folgende Cmdlet aus, um remote signierte PowerShell-Cmdlets und -Funktionen zuzulassen:
Set-ExecutionPolicy RemoteSigned
ArcGIS-Verbindungen verwalten
Mandantenadministratoren verwalten die Verbindungen, die durch Organisationsmitglieder zum Anmelden bei ArcGIS for Microsoft 365-Produkten verwendet werden.
Melden Sie sich mit folgendem Cmdlet in der PowerShell-Befehlszeilensitzung bei Microsoft Azure an, bevor Sie Funktionen des PowerShell-Moduls ArcGIS.Microsoft365 verwenden:Connect-MgGraph -Scopes "Organization.ReadWrite.All"
Nach der Anmeldung bei Microsoft Azure können Mandantenadministratoren eine Liste von ArcGIS-Verbindungen für Mitglieder der Organisation konfigurieren. Diese Liste wird als Dropdown-Menü angezeigt, wenn sich Benutzer bei einem Microsoft 365-Produkt, das in ArcGIS integriert ist, anmelden.
Der Mandantenadministrator kann PowerShell verwenden, um konfigurierte ArcGISConnectionInfo-Verbindungen zu erstellen, zu bearbeiten, zu entfernen, zu löschen, anzuzeigen oder zu exportieren. Die folgenden Tabellen enthalten Listen der verfügbaren PowerShell-Funktionen:
Neue ArcGIS-Verbindung festlegen
| Funktion | Erforderlich/Optional | Beschreibung |
|---|---|---|
Befehl: New-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default] | ||
-ArcGISConnectionUrl | Erforderlich | Legt den URL-Pfad für diese Verbindung fest. |
-ArcGISConnectionTitle | Erforderlich | Legt einen neuen Titel für diese Verbindung fest. |
-Default | Optional | Legt diese Verbindung als Standard fest (wird beim Anmelden als erstes angezeigt). |
Beispiele:
| ||
Legt die ArcGIS Online-Verbindung fest.
| Funktion | Erforderlich/Optional | Beschreibung |
|---|---|---|
Befehl: Set-ArcGISOnlineConnectionPermission [- allow] [- disallow] | ||
-ArcGISOnlineConnecionPermission | Erforderlich | Gibt an, ob der Benutzer eine Verbindung zu ArcGIS Onlineherstellen kann. |
-allow oder -disallow | Eine der Funktionen ist erforderlich. | Mit dieser Funktion wird entweder zugelassen oder unterbunden, dass der Benutzer eine Verbindung zu einer ArcGIS Online-Organisation herstellt, die nicht vom Administrator des Mandanten festgelegt wurde. |
Berechtigungen für URL-Verbindungen festlegen
| Funktion | Erforderlich/Optional | Beschreibung |
|---|---|---|
Befehl: Set-CustomURLConnectionPermission [- allow] [- disallow] | ||
-CustomURLConnectionPermission | Erforderlich | Gibt an, ob der Benutzer benutzerdefinierte URL-Verbindungen verwenden kann. |
-allow oder -disallow | Eine der Funktionen ist erforderlich. | Mit dieser Funktion wird entweder zugelassen oder unterbunden, dass der Benutzer manuell benutzerdefinierte Enterprise-Verbindungen eingeben kann. Wenn die Eingabe durch den Benutzer unterbunden wird, kann er nur auf URLs zugreifen, die vom Administrator des Mandanten festgelegt wurden. |
Verbindungsinformationen aktualisieren
| Funktion | Erforderlich/Optional | Beschreibung |
|---|---|---|
Befehl: Update-ArcGISConnection -ArcGISConnectionUrl [ARCGIS_CONNECTION_URL_STRING] -ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] [-Default] | ||
-ArcGISConnectionUrl | Erforderlich | Gibt einen vorhandenen URL-Pfad für diese Verbindung an. Vorsicht:Die URL muss mit einer vorhandenen Verbindung übereinstimmen, andernfalls schlägt der Befehl fehl. |
-ArcGISConnectionTitle | Erforderlich | Gibt den neuen Titel an, der für diese Verbindung verwendet oder aktualisiert werden soll. |
-Default | Optional | Legt diese Verbindung als Standard fest (wird beim Anmelden als erstes angezeigt). |
Beispiel: Update-ArcGISConnection -ArcGISConnectionUrl "https://xxx.maps.arcgis.com" -ArcGISConnectionTitle "My org 2022" -Default | ||
Vorhandene Verbindungen anzeigen
| Befehl | Beschreibung | |
|---|---|---|
Show-ArcGISConnections | Zeigt alle verfügbaren Verbindungen in PowerShell an. | |
Entfernen einer Verbindung
| Funktion | Erforderlich/Optional | Beschreibung |
|---|---|---|
Befehl: Remove-ArcGISConnection ArcGISConnectionTitle [ARCGIS_CONNECTION_TITLE] | ||
-ArcGISConnectionTitle | Erforderlich | Gibt eine einzelne Verbindung an, die aus den vorhandenen Verbindungen entfernt werden soll. |
Beispiel: Remove-ArcGISConnection -ArcGISConnectionTitle "My org 2022" | ||
ArcGIS-Verbindung löschen
| Befehl | Beschreibung | |
|---|---|---|
Clear-AllTenantArcGISConnections | Entfernen Sie alle hinzugefügten ArcGIS Online- und ArcGIS Enterprise-Verbindungszeichenfolgen, die vom Administrator des Mandanten eingerichtet wurden. | |
Alle ArcGIS-Verbindungseinstellungen zurücksetzen
| Befehl | Beschreibung | |
|---|---|---|
Reset-TenantArcGISSettings | Setzt alle ArcGIS-Verbindungseinstellungen zurück und stellt die Standardeinstellungen wieder her. Wenn Sie ArcGIS Online- oder benutzerdefinierte ArcGIS-Verbindungen zuvor unterbunden haben, werden diese Einstellungen auf die Standardeinstellungen zurückgesetzt, sodass solche Verbindungen wieder zugelassen werden. | |
Verbindungen exportieren
| Befehl | Beschreibung | |
|---|---|---|
Export-ArcGISConnections | Exportiert alle Verbindungen in eine lokale .txt-Datei. | |