Condividi tramite


Utilizzare cmdlet PowerShell per gli strumenti XRM per connettersi a CRM

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

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 CRM

Utilizzare i cmdlet per la connessione a CRM

Prerequisiti

  • Per utilizzare i cmdlet di strumenti XRM è necessaria una versione di PowerShell che non è precedente alla 3.0. 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 CRM

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 CRM Online o Microsoft Dynamics CRM (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 Microsoft Dynamics CRM (locale):

      $CRMOrgs = Get-CrmOrganizations –ServerUrl http://<CRM_Server_Host> –Credential $Cred
      
    • Se è in corso la connessione all'istanza di Microsoft Dynamics CRM Online:

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

      Nota

      Per il parametro DeploymentRegion i valori validi sono: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan e NorthAmerica2. Per il parametro OnlineType, i valori validi sono Office365 e LiveID.

    • 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 terza organizzazione nella variabile $CRMOrgs ("MyOrg"), utilizzare il comando seguente: $CRMOrgs[2].UniqueName.Ulteriori informazioni:TechNet: Accedere ai valori di matrice

Utilizzare i cmdlet per la connessione a CRM

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 CRM 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 CRM specificando le credenziali in linea

  1. Per connettersi al server CRM, utilizzare 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 Microsoft Dynamics CRM (locale):

      $CRMConn = Get-CrmConnection –ServerUrl http://<CRM_Server_Host> -Credential $Cred -OrganizationName <OrgName>
      
    • Se è in corso la connessione all'istanza di Microsoft Dynamics CRM Online:

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

      Nota

      Per il parametro DeploymentRegion i valori validi sono: NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan e NorthAmerica2. Per il parametro OnlineType, i valori validi sono Office365 e LiveID.

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

Utilizzare gli strumenti XRM per la connessione a CRM
Compilare applicazioni client di Windows tramite gli strumenti XRM

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright