Utilizzare cmdlet PowerShell per gli strumenti XRM per connettersi a Dynamics 365

  • Articolo

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Gli strumenti XRM forniscono i seguenti cmdlet Windows PowerShell da utilizzare per connettersi a Microsoft Dynamics 365 e per recuperare le organizzazioni cui l'utente corrente ha accesso: Get-CrmConnection e Get-CrmOrganizations.

In questo argomento

Prerequisiti

Registrare i cmdlet

Utilizzare i cmdlet per recuperare le organizzazioni da Dynamics 365

Utilizzare il cmdlet per connettersi a Dynamics 365

Prerequisiti

  • Per usare i cmdlet di strumenti XRM, devi disporre di PowerShell versione 3.0 o successive. Per controllare la versione, aprire una finestre di PowerShell, quindi eseguire il comando $Host

  • Impostare i criteri di esecuzione per eseguire gli script PowerShell con firma. A tale scopo, aprire una finestra di PowerShell come amministratore, quindi eseguire il comando: Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrare i cmdlet

Prima di poter utilizzare i cmdlet di PowerShell, è necessario registrarli.

  1. Scarica il pacchetto SDK di Microsoft Dynamics CRM. Eseguire il file di pacchetto per estrarre il contenuto del pacchetto. L'assembly di PowerShell (Microsoft.Xrm.Tooling.CrmConnector.Powershell.dll) e lo script (RegisterXRMTooling.ps1) per la registrazione dei cmdlet si trovano nella cartella \SDK\bin in SDK.

  2. Avviare Windows PowerShell nel computer con privilegi elevati (esegui come amministratore).

  3. Al prompt nella finestra, modificare la directory nella cartella contenente il file PowerShelldll e lo script per registrare i cmdlet. Ad esempio:

    cd c:\SDK\bin

  4. Eseguire lo script RegisterXRMTooling.ps1 per registrare l'assembly PowerShell degli strumenti XRM e installare lo snap-in di Windows PowerShell. Digitare il comando seguente e premere INVIO:

    .\RegisterXRMTooling.ps1

  5. Aggiungere lo snap-in di Windows PowerShell. Questo registra i cmdlet Get-CrmConnection e Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

È ora possibile utilizzare questi cmdlet di Windows PowerShell. Per elencare i cmdlet registrati, eseguire il comando seguente nella finestra di Windows PowerShell:

Get-Help “Crm”

Utilizzare i cmdlet per recuperare le organizzazioni da Dynamics 365

Utilizzare i cmdlet Get-CrmOrganizations per recuperare le organizzazioni a cui si ha accesso.

  1. Specificare le credenziali per la connessione all'istanza di Microsoft Dynamics 365 (online) o Dynamics 365 (locale). In seguito all'esecuzione del seguente comando viene richiesto di digitare nome utente e password per la connessione all'istanza di Dynamics 365 e verrà archiviata nella variabile $Cred.

    $Cred = Get-Credential

  2. Utilizzare il comando seguente per recuperare le organizzazioni e archiviare le informazioni della variabile $CRMOrgs:

    • Se è in corso la connessione al server Dynamics 365 (locale):

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

    • Se è in corso la connessione all'istanza di Microsoft Dynamics 365 (online):

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

      Nota

      Per il parametro DeploymentRegion, i valori validi sono NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND e NorthAmerica2. Per il parametro OnlineType, specifica Office365.

    • Se è in corso la connessione al server Dynamics 365 utilizzando l'autenticazione basata sulle attestazioni con l'area di autenticazione principale specificata:

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

  3. Le credenziali specificate vengono convalidate durante l'esecuzione del comando nel passaggio 2. Alla corretta esecuzione di comando, digitare il comando seguente e premere INVIO per visualizzare le organizzazioni a cui è possibile accedere:

    $CRMOrgs

    Elenco delle organizzazioni restituite dal cmdlet

    Suggerimento

    È possibile utilizzare la variabile utilizzata per archiviare le organizzazioni recuperate Dynamics 365 (in questo caso $CRMOrgs) con il cmdlet Get-CrmConnection per la connessione a Dynamics 365. Per specificare il nome dell'organizzazione, utilizzare il comando seguente: $CRMOrgs.UniqueName.

    Se è presente più di un valore dell'organizzazione archiviato nella variabile $CRMOrgs, è possibile riferirsi all'organizzazione nth utilizzando il comando seguente: $CRMOrgs[n-1]. Ad esempio, per riferirsi al nome univoco della seconda organizzazione nella variabile $CRMOrgs ("SampleOrg"), usa il comando seguente: $CRMOrgs[1].UniqueName.Ulteriori informazioni:TechNet: Accedere ai valori di matrice

Utilizzare il cmdlet per connettersi a Dynamics 365

Utilizzare il cmdlet Get-CrmConnection per connettersi a un'istanza Dynamics 365. I cmdlet consentono di utilizzare il controllo di accesso comune agli strumenti XRM per specificare le credenziali e connettersi a Dynamics 365 o consente di specificare le credenziali come parametri in linea.Ulteriori informazioni:Utilizzare gli strumenti XRM per il controllo di accesso comune nelle applicazioni client

Connettersi a Dynamics 365 tramite il controllo di accesso comune

  1. Se si desidera utilizzare il controllo di accesso comune per fornire le credenziali per connettersi a Dynamics 365, utilizzare il comando seguente. Le informazioni di connessione vengono archiviate nella variabile $CRMConn in modo da poterle utilizzare in seguito.

    $CRMConn = Get-CrmConnection -InteractiveMode

  2. Verrà visualizzata la finestra di dialogo LoginControl. Fornire le credenziali per la connessione all'istanza Dynamics 365, quindi fare clic su Accesso.

Connettersi a Dynamics 365 specificando le credenziali in linea

  1. Per connetterti a Dynamics 365, utilizza i seguenti comandi. Notare che questi comandi utilizzano la variabile $Cred creata in precedenza per archiviare la credenziale mentre si recuperano le organizzazioni. Le informazioni sulla connessione verranno archiviate nella variabile $CRMConn:

    • Se è in corso la connessione al server Dynamics 365 (locale):

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

    • Se è in corso la connessione all'istanza di Microsoft Dynamics 365 (online):

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

      Nota

      Per il parametro DeploymentRegion, i valori validi sono NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND e NorthAmerica2. Per il parametro OnlineType, specifica Office365.

    • Se è in corso la connessione al server Dynamics 365 utilizzando l'autenticazione basata sulle attestazioni con l'area di autenticazione principale specificata:

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

    Nota

    Per il parametro OrganizationName in tutti i comandi precedenti, è possibile specificare il nome univoco o il nome descrittivo dell'organizzazione. È inoltre possibile utilizzare il nome univoco o il nome descrittivo dell'organizzazione recuperata utilizzando il cmdlet Get-CrmOrganizations e archiviato nella variabile $CRMOrgs. È ad esempio possibile utilizzare $CRMOrgs[x].UniqueName o $CRMOrgs[x].FriendlyName.

  2. Le credenziali specificate vengono convalidate durante l'esecuzione del comando nel passaggio 1. Alla corretta esecuzione del cmdlet, digitare il comando seguente e premere INVIO per visualizzare le informazioni e lo stato di connessione:

    $CRMConn

    Informazioni e stato della connessione CRM

Vedere anche

Usare i costruttori di CrmServiceClient per connettere a Dynamics 365
Compilare applicazioni client di Windows tramite gli strumenti XRM
Blog: Modulo PowerShell per eseguire operazioni sui dati e la modifica delle impostazioni di sistema e utente in CRM

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright