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

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

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 CRM

Brug cmdletten til at oprette forbindelse til CRM

Forudsætninger

• For at kunne bruge cmdletterne til XRM-værktøjerne skal du have version 3.0 eller en senere version af PowerShell. 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 CRM

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

1. Angiv dine legitimationsoplysninger for at oprette forbindelse til din Microsoft Dynamics CRM (i det lokale miljø)- eller Microsoft Dynamics CRM 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 Microsoft Dynamics CRM (i det lokale miljø)-serveren:

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

   • Hvis du opretter forbindelse til Microsoft Dynamics CRM Online-forekomsten:

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

     Bemærk

     For DeploymentRegion-parameteren er NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan og NorthAmerica2 gyldige værdier. For parameteren OnlineType er de gyldige værdier Office365 og LiveID.

   • 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 tredje organisation i variablen $CRMOrgs ("MyOrg") skal du f.eks. bruge følgende kommando: $CRMOrgs[2].UniqueName.Flere oplysninger:TechNet: Adgang til værdier i en matrix

Brug cmdletten til at oprette forbindelse til CRM

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 CRM 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 CRM ved at angive legitimationsoplysninger indbygget

1. Du kan bruge følgende kommandoer til at oprette forbindelse til CRM. 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 Microsoft Dynamics CRM (i det lokale miljø)-serveren:

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

   • Hvis du opretter forbindelse til Microsoft Dynamics CRM Online-forekomsten:

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

     Bemærk

     For DeploymentRegion-parameteren er NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan og NorthAmerica2 gyldige værdier. For parameteren OnlineType er de gyldige værdier Office365 og LiveID.

   • 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 2. 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å

Brug XRM-værktøjer for at oprette forbindelse til CRM
Opbygge Windows-klientprogrammer ved hjælp af XRM-værktøjerne

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret