PowerShell-cmdlets gebruiken voor XRM-tooling om verbinding met Dynamics 365 te maken

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

XRM-tooling biedt de volgende Windows PowerShell-cmdlets die u kunt gebruiken om verbinding te maken met Microsoft Dynamics 365 en organisaties op te halen waartoe de huidige gebruiker toegang heeft: Get-CrmConnection en Get-CrmOrganizations.

In dit onderwerp

Vereisten

De cmdlet registreren

De cmdlet gebruiken om organisaties op te halen vanuit Dynamics 365

De cmdlet gebruiken om verbinding te maken met Dynamics 365

Vereisten

• Als u de cmdlets in de XRM-tooling wilt gebruiken, hebt u versie 3.0 van Powershell of een latere versie nodig. U kunt de versie controleren door een Powershell-venster te openen en de volgende opdracht uit te voeren $Host

• Stel het uitvoeringsbeleid zo in dat het de ondertekende Powershell-scripts uitvoert. Als u dit wilt, opent u een Powershell-venster als beheerder en voert u de volgende opdracht uit: Set-ExecutionPolicy -ExecutionPolicy AllSigned

De cmdlet registreren

Voordat u de Powershell-cmdlets kunt gebruiken, moet u deze registreren.

1. Download het Microsoft Dynamics CRM SDK-pakket. Voer het pakketbestand uit om de inhoud van het pakket uit te pakken. De Powershell-assembly (Microsoft.Xrm.Tooling.CrmConnector.Powershell.dll) en het script (RegisterXRMTooling.ps1) voor het registreren van de cmdlets bevinden zich in de map \SDK\bin in de SDK.

2. Start Windows PowerShell op uw computer met extra bevoegdheden (uitvoeren als beheerder).

3. Wijzig bij de prompt uw directory in de map die het Powershelldll-bestand bevat en het script voor het registreren van de cmdlets. Bijvoorbeeld:

   cd c:\SDK\bin
   

4. Voer het script RegisterXRMTooling.ps1 uit om de Powershell-assembly van de XRM-tooling te registreren en installeer de Windows PowerShell-module. Typ de volgende opdracht en druk op ENTER:

   .\RegisterXRMTooling.ps1
   

5. Voeg de Windows PowerShell-module toe. Hiermee worden de Get-CrmConnection- en Get-CrmOrganizations-cmdlets geregistreerd.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

U bent nu klaar om deze Windows PowerShell-cmdlets te gebruiken. Als u de cmdlets die u hebt geregistreerd wilt weergeven, voert u de volgende opdracht uit in het Windows PowerShell-venster:

Get-Help “Crm”

De cmdlet gebruiken om organisaties op te halen vanuit Dynamics 365

Gebruik de Get-CrmOrganizations-cmdlet voor het ophalen van de organisaties waartoe u toegang hebt.

1. Geef de referenties op om verbinding te maken met uw Dynamics 365 (on-premises)- of Microsoft Dynamics 365 (online)-exemplaar. Als u de volgende opdracht uitvoert, wordt u gevraagd om uw gebruikersnaam en wachtwoord te typen om verbinding te maken met het Dynamics 365-exemplaar. Het wordt opgeslagen in de variabele $Cred.

   $Cred = Get-Credential
   

2. Gebruik de volgende opdracht om uw organisaties op te halen en de gegevens op te slaan in de variabele $CRMOrgs:

   • Als u verbinding maakt met de Dynamics 365 (on-premises)-server:

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

   • Als u verbinding maakt met het Microsoft Dynamics 365 (online)-exemplaar:

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

     Notitie

     Geldige waarden voor de parameter DeploymentRegion zijn NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND en NorthAmerica2. Geef voor de parameterOnlineTypeOffice365 op.

   • Als u verbonden bent met de Dynamics 365-server via de op claims gebaseerde verificatie voor de opgegeven thuisdomein:

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

3. Uw opgegeven referenties worden gevalideerd wanneer u de opdracht in stap 2 uitvoert. Typ wanneer de opdracht is uitgevoerd, de volgende opdracht en druk op ENTER om de organisaties weer te geven waartoe u toegang hebt:

   $CRMOrgs
   

   

   Tip

   U kunt de variabele gebruiken die werd gebruikt voor het opslaan van de opgehaalde Dynamics 365-organisaties (in dit geval $CRMOrgs) met de Get-CrmConnection-cmdlet om verbinding te maken met Dynamics 365. Als u de organisatienaam wilt opgeven, gebruikt u de volgende opdracht: $CRMOrgs.UniqueName.

   Als er meer dan één organisatiewaarde is opgeslagen in de variabele $CRMOrgs, kunt u verwijzen naar de nth-organisatie met de volgende opdracht: $CRMOrgs[n-1]. U kunt bijvoorbeeld verwijzen naar de unieke naam van de tweede organisatie in de variabele $CRMOrgs (”SampleOrg”) met de volgende opdracht: $CRMOrgs[1].UniqueName.Meer informatie:TechNet: Toegang verkrijgen tot waarden in een matrix

De cmdlet gebruiken om verbinding te maken met Dynamics 365

Gebruik de cmdlet Get-CrmConnection om verbinding te maken met een Dynamics 365-exemplaar. Met de cmdlet kunt u het algemene aanmeldingsbesturingselement van de XRM-tooling gebruiken om uw referenties op te geven en verbinding te maken met Dynamics 365 of kunt u uw referenties als inline parameters opgeven.Meer informatie:Gebruik het XRM-aanmeldingsbesturingselement in uw clienttoepassingen

Verbinding met Dynamics 365 maken via het algemene besturingselement voor aanmelding

1. Als u het algemene aanmeldingsbesturingselement wilt gebruiken om uw referenties op te geven om verbinding te maken met Dynamics 365, gebruikt u de volgende opdracht. De verbindingsgegevens worden opgeslagen in de variabele $CRMConn zodat u deze later kunt gebruiken.

   $CRMConn = Get-CrmConnection -InteractiveMode
   

2. Het dialoogvenster LoginControl wordt weergegeven. Geef uw referenties op om verbinding te maken met uw Dynamics 365-exemplaar en klik op Aanmelden.

Verbinding met Dynamics 365 maken door inline referenties op te geven

1. Als u verbinding met Dynamics 365 wilt maken, gebruikt u de volgende opdrachten. Deze opdrachten gebruiken de variabele $Cred die eerder is gemaakt om de referentie op te slaan tijdens het ophalen van de organisaties. De verbindingsinformatie is opgeslagen in de variabele $CRMConn:

   • Als u verbinding maakt met de Dynamics 365 (on-premises)-server:

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

   • Als u verbinding maakt met het Microsoft Dynamics 365 (online)-exemplaar:

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

     Notitie

     Geldige waarden voor de parameter DeploymentRegion zijn NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND en NorthAmerica2. Geef voor de parameterOnlineTypeOffice365 op.

   • Als u verbonden bent met de Dynamics 365-server via de op claims gebaseerde verificatie voor de opgegeven thuisdomein:

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

   Notitie

   Voor de parameter OrganizationName in alle voorgaande opdrachten kunt u de unieke organisatienaam of de beschrijvende naam opgeven. U kunt ook de unieke organisatienaam of de beschrijvende naam gebruiken die u hebt opgehaald met de Get-CrmOrganizations-cmdlet en opgeslagen in de variabele $CRMOrgs. U kunt bijvoorbeeld gebruikmaken van $CRMOrgs[x].UniqueName of $CRMOrgs[x].FriendlyName.

2. Uw opgegeven referenties worden gevalideerd wanneer u de opdracht in stap 1 uitvoert. Typ wanneer de cmdlet is uitgevoerd, de volgende opdracht en druk op ENTER om de verbindingsgegevens en -status weer te geven:

   $CRMConn
   

   

Zie ook

CrmServiceClient-constructors gebruiken om verbinding te maken met Dynamics 365
Windows clienttoepassingen maken met de XRM-hulpprogramma's
Blog: PowerShell-module voor het uitvoeren van gegevensbewerkingen en het manipuleren van gebruiker- en systeeminstellingen in CRM

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht