Verwenden von PowerShell-Cmdlets für XRM-Tooling, um eine Verbindung mit Dynamics 365 herzustellen

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

XRM-Ttooling stellt die folgenden Windows PowerShell cmdlets bereit, die Sie verwenden können, um eine Verbindung mit Microsoft Dynamics 365 herzustellen und Organisationen abzurufen, auf die der aktuelle Benutzer Zugriff hat: Get-CrmConnection und Get-CrmOrganizations.

In diesem Thema

Voraussetzungen

Registrieren des Cmdlets

Verwenden Sie das Cmdlet, um Organisationen von Dynamics 365 abzurufen

Verwenden des Cmdlet, um die Verbindung mit Dynamics 365 herzustellen

Voraussetzungen

• Um die XRM-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-Scripts fest. Öffnen Sie hierzu als Administrator ein PowerShell-Fenster und führen Sie den folgenden Befehl aus: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrieren des Cmdlets

Bevor Sie die PowerShell cmdlets verwenden könnne, müssen Sie sie registrieren.

1. Laden Sie das Microsoft Dynamics CRM SDK-Paket herunter. Führen Sie die Paketdatei aus, um den Inhalt des Pakets zu extrahieren. Die PowerShell-Assembly (Microsoft.Xrm.Tooling.CrmConnector.Powershell.dll) und das Skript (RegisterXRMTooling.ps1) für das Registrieren der Cmdlets sind im Ordner \SDK\bin folder in the SDK.

2. Starten Sie Windows PowerShell auf dem Computer mit erweiterten Rechten (als Administrator ausführen.)

3. Ändern Sie im bei der Eingabeaufforderung das Verzeichnis zum Ordner, in dem die Datei PowerShelldll und das Skript für das Registrieren der Cmdlets enthalten sind. Beispiel:

   cd c:\SDK\bin
   

4. Führen Sie das Skript RegisterXRMTooling.ps1 zum Registrieren der XRM-Tooling PowerShell-Assembly aus, und installieren Sie das Windows PowerShell-Snap-in. Geben Sie den folgenden Befehl ein, und drücken Sie die EINGABETASTE:

   .\RegisterXRMTooling.ps1
   

5. Fügen Sie das -Snap-In von Windows PowerShell hinzu. Damit werden die Get-CrmConnection und Get-CrmOrganizations-Cmdlets registriert.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

Sie können jetzt diese Windows PowerShell-Cmdlets verwenden. Um die Cmdlets aufzulisten, die Sie registriert haben, führen Sie den folgenden Befehl im Windows PowerShell-Fenster aus.

Get-Help “Crm”

Verwenden Sie das Cmdlet, um Organisationen von Dynamics 365 abzurufen

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

1. Stellen Sie die Anmeldeinformationen für die Verbindun mit Ihrer Dynamics 365 (lokal)- oder Microsoft Dynamics 365 (online)-Instanz bereit. Bei Ausführung des folgenden Befehls werden Sie aufgefordert, Ihren Benutzernamen und Ihr Kennwort einzugeben, um eine Verbindung mit der Dynamics 365-Instanz herzustellen, und sie wird in der Datei $Cred 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 eine Verbindung mit dem Dynamics 365 (lokal)-Server herstellen:

     $CRMOrgs = Get-CrmOrganizations –ServerUrl http://<CRM_Server_Host> –Credential $Cred
     

   • Wenn Sie eine Verbindung mit der Microsoft Dynamics 365 (online)-Instanz herstellen:

     $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. Geben Sie für den Parameter OnlineTypeOffice365 an.

   • Wenn Sie mithilfe der anspruchsbasierten Authentifizierung eine Verbindung mit dem Dynamics 365-Server für den privaten angegebenen Bereich herstellen:

     $CRMOrgs = Get-CrmOrganizations –ServerUrl http://<CRM_Server_Host> –Credential $Cred –HomRealmURL http://<Identity_Provider_Address>
     

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
   

   

   Tipp

   Sie können die Variable, die verwendet wurde, um die abgerufenen Dynamics 365-Organisationen (in diesem Fall $CRMOrgs) zu speichern, mit dem Get-CrmConnection-Cmdlet verwenden, um eine Verbindung mit Dynamics 365 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 ("SampleOrg") verweisen, verwenden Sie den folgenden Befehl: $CRMOrgs[1].UniqueName.Weitere Informationen:TechNet: Zugreifen auf Werte in einem Array

Verwenden des Cmdlet, um die Verbindung mit Dynamics 365 herzustellen

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

Mithilfe des allgemeinen Anmeldungssteuerelement zu Dynamics 365 verbinden

1. Wenn Sie das allgemeine Anmeldungssteuerelement verwenden möchten, um die Anmeldeinformationen bei der Herstellung einer Verbindung mit Dynamics 365 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 Dynamics 365-Instanz herzustellen, und klicken Sie auf Anmelden.

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

1. Verwenden Sie folgende Befehle, um die Verbindung mit Dynamics 365 herzustellen. 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 eine Verbindung mit dem Dynamics 365 (lokal)-Server herstellen:

     $CRMConn = Get-CrmConnection –ServerUrl http://<CRM_Server_Host> -Credential $Cred -OrganizationName <OrgName>
     

   • Wenn Sie eine Verbindung mit der Microsoft Dynamics 365 (online)-Instanz herstellen:

     $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. Geben Sie für den Parameter OnlineTypeOffice365 an.

   • Wenn Sie mithilfe der anspruchsbasierten Authentifizierung eine Verbindung mit dem Dynamics 365-Server für den privaten angegebenen Bereich herstellen:

     $CRMConn = Get-CrmConnection –ServerUrl http://<CRM_Server_Host> -Credential $Cred -OrganizationName <OrgName> –HomRealmURL http://<Identity_Provider_Address>
     

   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
   

   

Siehe auch

CrmServiceClient-Konstruktoren verwenden, um eine Verbindung mit Dynamics 365 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 CRM

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright