Freigeben über


Verwenden Sie PowerShell-Cmdlets für XRM-Tools, um eine Verbindung mit Microsoft Dataverse herzustellen.

XRM-Tooling stellt Ihnen die folgenden Windows PowerShell-Cmdlets zur Verfügung, mit denen Sie eine Verbindung mit Dataverse herstellen und Organisationen abrufen können, auf die der aktuelle Benutzer Zugriff hat: Get-CrmConnection und Get-CrmOrganizations.

Voraussetzungen

  • Um die XRM Tooling-Cmdlets zu verwenden, benötigen Sie PowerShell Version 3.0 oder höher. Öffnen Sie zur Prüfung der Version ein PowerShell-Fenster und führen Sie dann den folgenden Befehl aus: $Host.

  • Legen Sie die Ausführungsrichtlinie für die Ausführung der signierten PowerShell-Skripts fest. Öffnen Sie hierzu als Administrator ein PowerShell-Fenster und führen Sie den folgenden Befehl aus: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Rufen Sie das Cmdlet Microsoft.Xrm.Tooling.CrmConnector.PowerShell ab.

Bevor Sie das Cmdlet Microsoft.Xrm.Tooling.CrmConnector.PowerShell verwenden können, müssen Sie es installieren. Das Cmdlet XRM-Tooling PowerShell ist in der PowerShell Gallery hier verfügbar. So laden Sie das Cmdlet herunter und installieren es

Öffnen Sie PowerShell oder PowerShell ISE im Admin-Modus und führen Sie den folgenden Befehl aus:

Install-Module -Name Microsoft.Xrm.Tooling.CrmConnector.PowerShell

Wenn Sie das Modul in der Vergangenheit installiert haben, können Sie es mit dem folgenden Befehl aktualisieren:

Update-Module -Name Microsoft.Xrm.Tooling.CrmConnector.PowerShell

Sie sind nun bereit, das Cmdlet Microsoft.Xrm.Tooling.CrmConnector.PowerShell zu verwenden. Um die von Ihnen registrierten Funktionen aufzulisten, führen Sie den folgenden Befehl im PowerShell-Fenster aus:

Get-Help “Crm”  

Verwenden des Cmdlet zum Abrufen von Organisationen aus Dataverse

Verwenden Sie das Get-CrmOrganizations-Cmdlet, um Organisationen abzurufen, auf die Sie Zugriff haben.

  1. Stellen Sie die Anmeldeinformationen für die Verbindung mit Ihrer Dataverse-Instanz bereit. Bei Ausführung des folgenden Befehls werden Sie aufgefordert, Ihren Benutzernamen und Ihr Kennwort einzugeben, um eine Verbindung mit der Dataverse-Instanz herzustellen. Die Daten werden in der $Cred-Variable gespeichert.

    $Cred = Get-Credential  
    
  2. Verwenden Sie den folgenden Befehl, um die Organisationen abzurufen, und speichern Sie die Informationen in der Variable $CRMOrgs

    • Wenn Sie sich mit einer Dataverse-Instanz verbinden:

      $CRMOrgs = Get-CrmOrganizations -Credential $Cred -DeploymentRegion NorthAmerica –OnlineType Office365  
      

      Hinweis

      Für den Parameter DeploymentRegion sind gültige Werte NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND und NorthAmerica2. Für den OnlineType Parameter, definieren Sie Office365.

  3. Die angegebenen Anmeldeinformationen werden überprüft, wenn Sie den Befehl in Schritt 2 ausführen. Bei der erfolgreichen Ausführung des Befehls geben Sie den folgenden Befehl ein, und drücken Sie die EINGABETASTE, um die Organisationen anzuzeigen, auf die Sie Zugriff besitzen:

    $CRMOrgs  
    

    Dataverse-Organisationsinformationen.

Tipp

Sie können die Variable, die zum Speichern der abgerufenen Dataverse-Organisationen (in diesem Fall $CRMOrgs) verwendet wurde, mit dem Get-CrmConnection-Cmdlet verwenden, um eine Verbindung mit Dataverse herzustellen. Um den Namen der Organisation anzugeben, verwenden Sie den folgenden Befehl: $CRMOrgs.UniqueName.

Wenn mehr als einen Organisationswert in der $CRMOrgs-Variable gespeichert ist, können auf die nth-Organisation mithilfe des folgenden Befehls verweisen: $CRMOrgs[n-1]. Wenn Sie beispielsweise auf den eindeutigen Namen der zweiten Organisation in der $CRMOrgs-Variable verweisen, verwenden Sie den folgenden Befehl: $CRMOrgs[1].UniqueName.

Verwenden des Cmdlets, um eine Verbindung mit Dataverse herzustellen

Verwenden Sie das Get-CrmConnection-Cmdlet, um eine Verbindung mit der Dataverse-Instanz herzustellen. Mit dem Cmdlet können Sie entweder das allgemeine Anmeldungssteuerelement von XRM-Tooling verwenden, um die Anmeldeinformationen anzugeben und eine Verbindung mit Dataverse herzustellen oder um die Anmeldeinformationen als Inline-Parameter anzugeben. Weitere Informationen: Verwenden des allgemeinen XRM-Tooling-Anmeldungssteuerelements

Wichtig

Bevor Sie das Get-CrmConnection-Cmdlet verwenden, stellen Sie sicher, dass Sie den folgenden Befehl verwenden, um die Verwendung von TLS 1.2 durch PowerShell zur Verbindung mit Ihrer Dataverse-Instanz zu erzwingen.
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12
Weitere Informationen über die TLS 1.2-Anforderung für die Dataverse-Verbindung Blogbeitrag: Updates zur Dataverse-Verbindungssicherheit

Mit dem allgemeinen Anmeldungssteuerelement eine Verbindung mit Dataverse herstellen

  1. Wenn Sie das allgemeine Anmeldungssteuerelement verwenden möchten, um die Anmeldeinformationen bei der Herstellung einer Verbindung mit Dataverse bereitzustellen, verwenden Sie den folgenden Befehl. Die Informationen werden in der $CRMConn-Variablen gespeichert, damit Sie sie später verwenden können.

    $CRMConn = Get-CrmConnection -InteractiveMode  
    
  2. Das Dialogfeld Anmeldesteuerelement wird angezeigt. Stellen Sie die Anmeldeinformationen bereit, um eine Verbindung mit der Dataverse-Instanz herzustellen, und klicken Sie auf Anmelden.

Stellen Sie eine Verbindung mit Dataverse her, indem Sie die Anmeldeinformationen inline angeben.

  1. Um eine Verbindung mit Dataverse herzustellen, verwenden Sie die folgenden Befehle. Beachten Sie, dass diese befehle die $Cred-Variable verwenden, um die Anmeldeinformationen beim Abrufen der Organisationen zu speichern. Die Verbindungsinformationen werden in der $CRMConn-Variablen gespeichert:

    • Wenn Sie sich mit einer Dataverse-Instanz verbinden:

      $CRMConn = Get-CrmConnection -Credential $Cred -DeploymentRegion <Deployment region name> –OnlineType Office365 –OrganizationName <OrgName>  
      

      Hinweis

      Für den Parameter DeploymentRegion sind gültige Werte NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND und NorthAmerica2. Für den OnlineType Parameter, definieren Sie Office365.

      Hinweis

      Für den Parameter OrganizationName in allen vorangehenden Befehlen können Sie entweder den eindeutigen Namen der Organisation oder den Anzeigenamens angeben. Sie können auch den eindeutigen Namen der Organisation oder den Anzeigenamen verwenden, den Sie mithilfe des Get-CrmOrganizations- Cmdlets erhalten und in der $CRMOrgs-Variablen gespeichert haben. So können Sie beispielsweise $CRMOrgs[x].UniqueName oder $CRMOrgs[x].FriendlyName verwenden.

  2. Die angegebenen Anmeldeinformationen werden überprüft, wenn Sie den Befehl in Schritt 1 ausführen. Bei der erfolgreichen Ausführung des cmdlet geben Sie den folgenden Befehl ein, und drücken Sie die EINGABETASTE, um die Verbindungsinformationen und den Status anzuzeigen:

     $CRMConn  
    

    Dataverse-Verbindungsinformationen und -status.

Verbindung mit Dataverse mit OAuth herstellen

Die OAuth-Authentifizierung wird intern von XRM-Tools verwendet, wenn Sie den Parameter -InteractiveMode angeben.

$CRMConn = Get-CrmConnection -InteractiveMode  

Die OAuth-Authentifizierung kann auch angegeben werden, wenn eine Verbindungszeichenfolge verwendet wird, bei der AuthType=OAuth oder AuthType=ClientSecret ist.

$CRMConn = Get-CrmConnection -ConnectionString "AuthType=ClientSecret;ClientId=..."

Weitere Informationen: Verwenden von Verbindungszeichenfolgen im XRM-Tooling zum Herstellen einer Verbindung zu Microsoft Dataverse

Siehe auch

Verwenden der XRM-Tooling-API, um eine Verbindung mit Dataverse herzustellen
Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools
Blog: PowerShell-Modul für die Ausführung von Datenvorgängen und die Bearbeitung der Benutzer- und Systemeinstellungen in Dataverse

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).