Brug PowerShell cmdlets for XRM-værktøjer til at oprette forbindelse til Dynamics 365

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

XRM-værktøjer giver dig følgende Windows PowerShell-cmdletter, som du kan bruge til at oprette forbindelse til Microsoft Dynamics 365 og hente organisationer, som den aktuelle bruger har adgang til: Get-CrmConnection og Get-CrmOrganizations.

Dette emne indeholder

Forudsætninger

Registrere cmdletterne

Brug cmdletten til at hente organisationer fra Dynamics 365

Bruge cmdletten til at oprette forbindelse til Dynamics 365

Forudsætninger

• For at bruge cmdletterne til XRM-værktøjer skal du have PowerShell version 3.0 eller nyere. Du kan se din version ved at åbne et PowerShell-vindue og derefter køre følgende kommando: $Host

• Angiv, at udførelsespolitikken skal køre de signerede PowerShell-scripts. Det gøres ved at åbne et PowerShell-vindue som administrator og køre kommandoen: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrere cmdletterne

Du skal registrere PowerShell-cmdletterne, før du kan bruge dem.

1. Hent SDK-pakken til Microsoft Dynamics CRM. Kør pakkefile for at pakke indholdet af pakken ud.PowerShell-assemblyen (Microsoft.Xrm.Tooling.CrmConnector.Powershell.dll) og scriptet (RegisterXRMTooling.ps1) til registrering af cmdletterne er placeret i mappen \SDK\bin i SDK.

2. Start Windows PowerShell på computeren med administratorrettigheder (kør som administrator).

3. Ved prompten skal du ændre mappen til den mappe som indeholder filen PowerShelldll og scriptet til registrering af cmdletterne. Eksempel:

   cd c:\SDK\bin
   

4. Kør scriptet RegisterXRMTooling.ps1 for at registrere XRM-værtøjets PowerShell-assembly, og installer snap-in'en Windows PowerShell. Skriv følgende kommando, og tryk på ENTER:

   .\RegisterXRMTooling.ps1
   

5. Tilføj Windows PowerShell-snap-in'en. På denne måde registreres cmdletterne Get-CrmConnection og Get-CrmOrganizations.

   Add-PSSnapin Microsoft.Xrm.Tooling.Connector
   

Du er nu klar til at bruge disse Windows PowerShell-cmdletter. Kør følgende kommando i Windows PowerShell-vinduet for at få vist de cmdletter, du har registreret:

Get-Help “Crm”

Brug cmdletten til at hente organisationer fra Dynamics 365

Brug Get-CrmOrganizations-cmdletten til hentning af de organisationer, som du har adgang til.

1. Angiv dine legitimationsoplysninger for at oprette forbindelse til din Dynamics 365 (i det lokale miljø)- eller Microsoft Dynamics 365 (online)-forekomst. Når du kører følgende kommando, bliver du bedt om at skrive dit brugernavn og din adgangskode for at oprette forbindelse til Dynamics 365-forekomsten, og de gemmes i variablen $Cred.

   $Cred = Get-Credential
   

2. Brug følgende kommando til at hente dine organisationer og gemme oplysningerne i variablen $CRMOrgs:

   • Hvis du opretter forbindelse til Dynamics 365 (i det lokale miljø)-serveren:

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

   • Hvis du opretter forbindelse til Microsoft Dynamics 365 (online)-forekomsten:

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

     Bemærk

     For DeploymentRegion-parameteren er NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND og NorthAmerica2 gyldige værdier. For OnlineType-parameteren skal du angive Office365.

   • Hvis du opretter forbindelse til Dynamics 365-serveren ved hjælp af kravsbaseret godkendelse mod det angivne startdomæne:

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

3. Dine angivne legitimationsoplysninger valideres, når du kører kommandoen i trin 2. Efter vellykket udførelse af kommandoen skal du skrive følgende kommando og trykke på ENTER for at få vist de organisationer, som du har adgang til:

   $CRMOrgs
   

   

   Tip

   Du kan bruge den variabel, der blev brugt til at gemme de hentede Dynamics 365-organisationer (i dette tilfælde $CRMOrgs), med Get-CrmConnection-cmdletten for at oprette forbindelse til Dynamics 365. Brug følgende kommando til at angive navnet på org: $CRMOrgs.UniqueName.

   Hvis der er mere end én organisationsværdi gemt i variablen $CRMOrgs, kan du referere til nth-organisationen ved hjælp af følgende kommando: $CRMOrgs[n-1]. For at henvise til det entydige navn på den anden organisation i variablen $CRMOrgs ("SampleOrg") skal du f.eks. bruge følgende kommando: $CRMOrgs[1].UniqueName.Flere oplysninger:TechNet: Adgang til værdier i en matrix

Bruge cmdletten til at oprette forbindelse til Dynamics 365

Brug Get-CrmConnection-cmdletten til at oprette forbindelse til en Dynamics 365-forekomst. Cmdletterne giver dig mulighed for enten at bruge kontrolelementet til fælles logon til XRM-værktøjer til at angive dine legitimationsoplysninger og oprette forbindelse til Dynamics 365, eller du kan angive dine legitimationsoplysninger som indbyggede parametre.Flere oplysninger:Brug XRM-værktøjet til fælles login-kontrolelement i dine klientprogrammer

Opret forbindelse til Dynamics 365 ved hjælp af kontrolelementet til fælles logon

1. Hvis du vil bruge kontrolelementet til fælles logon til at angive dine legitimationsoplysninger for at oprette forbindelse til Dynamics 365, skal du bruge følgende kommando. Forbindelsesoplysningerne gemmes i variablen $CRMConn, så du kan bruge dem senere.

   $CRMConn = Get-CrmConnection -InteractiveMode
   

2. Dialogboksen LoginControl vises. Angiv dine legitimationsoplysninger for at oprette forbindelse til din Dynamics 365-forekomst, og klik på Login.

Opret forbindelse til Dynamics 365 ved at angive legitimationsoplysninger indbygget

1. Du kan bruge følgende kommandoer til at oprette forbindelse til Dynamics 365. Bemærk, at disse kommandoer bruger variablen $Cred, der blev oprettet tidligere, til at gemme legitimationsoplysningerne under hentning af organisationerne. Forbindelsesoplysningerne gemmes i variablen $CRMConn:

   • Hvis du opretter forbindelse til Dynamics 365 (i det lokale miljø)-serveren:

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

   • Hvis du opretter forbindelse til Microsoft Dynamics 365 (online)-forekomsten:

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

     Bemærk

     For DeploymentRegion-parameteren er NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND og NorthAmerica2 gyldige værdier. For OnlineType-parameteren skal du angive Office365.

   • Hvis du opretter forbindelse til Dynamics 365-serveren ved hjælp af kravsbaseret godkendelse mod det angivne startdomæne:

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

   Bemærk

   For parameteren OrganizationName i alle foregående kommandoer kan du enten angive organisationens entydige navn eller fulde navn. Du kan også bruge organisationens entydige navn eller fulde navn, som du hentede ved hjælp af Get-CrmOrganizations-cmdletten og gemte i variablen $CRMOrgs. Du kan f.eks. bruge $CRMOrgs[x].UniqueName eller $CRMOrgs[x].FriendlyName.

2. Dine angivne legitimationsoplysninger valideres, når du kører kommandoen i trin 1. Efter vellykket udførelse af cmdletten skal du skrive følgende kommando og trykke på ENTER for at få vist oplysninger om og status for forbindelse:

   $CRMConn
   

   

Se også

Bruge CrmServiceClient-konstruktører til at oprette forbindelse til Dynamics 365
Opbygge Windows-klientprogrammer ved hjælp af XRM-værktøjerne
Blog: PowerShell-modulet til at udføre databehandlinger og manipulere bruger og system indstillinger i CRM

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret