Partager via

Utiliser les applets de commande PowerShell pour que les outils XRM se connectent à CRM

  • Article

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Les outils XRM vous fournissent les applets de commande Windows PowerShell suivants que vous pouvez utiliser pour vous connecter à Microsoft Dynamics 365 et récupérer les organisations auxquelles l’utilisateur actuel a accès : Get-CrmConnection et Get-CrmOrganizations.

Contenu de la rubrique

Conditions préalables

Enregistrer les applets de commande

Utilisez l’applet de commande pour récupérer des organisations auprès de CRM

Utiliser l’applet de commande pour se connecter à CRM

Conditions préalables

  • Pour pouvoir utiliser les applets de commande des outils XRM, vous devez disposer d’une version de PowerShell qui ne soit pas antérieure à la version 3.0. Pour vérifier la version, ouvrez une fenêtre PowerShell et exécutez la commande suivante : $Host.

  • Définissez la stratégie d'exécution pour exécuter les scripts PowerShell signés. Pour cela, ouvrez une fenêtre PowerShell en tant qu’administrateur, puis exécutez la commande suivante : Set-ExecutionPolicy -ExecutionPolicy AllSigned

Enregistrer les applets de commande

Avant de pouvoir utiliser les applets de commande PowerShell, vous devez les enregistrer.

  1. Téléchargez le package Kit de développement logiciel (SDK) de Microsoft Dynamics CRM. Exécutez le fichier de package pour extraire le contenu du package. L'assembly PowerShell (Microsoft.Xrm.Tooling.CrmConnector.Powershell.dll) et le script (RegisterXRMTooling.ps1) permettant l'inscription des applets de commande sont situés dans le dossier \SDK\bin dans le Kit de développement logiciel.

  2. Démarrez Windows PowerShell sur votre ordinateur avec des privilèges élevés (exécuter en tant qu'administrateur).

  3. À l’invite, modifiez votre répertoire pour le dossier contenant le fichier dllPowerShell et le script permettant d'inscrire les applets de commande. Par exemple :

    cd c:\SDK\bin

  4. Exécutez le script RegisterXRMTooling.ps1 pour inscrire l'assembly PowerShell des outils XRM et installez le composant logiciel enfichable Windows PowerShell. Entrez la commande qui suit, puis appuyez sur Entrée :

    .\RegisterXRMTooling.ps1

  5. Ajoutez le composant logiciel enfichable Windows PowerShell. Cette opération inscrit les applets de commande Get-CrmConnection et Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

Vous êtes à présent prêt à utiliser ces applets de commande Windows PowerShell. Pour répertorier les applets de commande que vous avez inscrits, exécutez la commande suivante à l'invite de la fenêtre Windows PowerShell :

Get-Help “Crm”

Utilisez l’applet de commande pour récupérer des organisations auprès de CRM

Utilisez l’applet de commande Get-CrmOrganizations pour récupérer les organisations auxquelles vous avez accès.

  1. Fournissez vos informations d'identification pour vous connecter à votre instance Microsoft Dynamics CRM (local) ou Microsoft Dynamics CRM Online. La commande suivante vous invite à entrer votre nom d’utilisateur et votre mot de passe pour vous connecter à l’instance Dynamics 365 ; ces informations seront stockées dans la variable $Cred.

    $Cred = Get-Credential

  2. Utilisez la commande suivante pour récupérer vos organisations et stockez les informations dans la variable $CRMOrgs :

    • Si vous vous connectez au serveur Microsoft Dynamics CRM (local) :

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

    • Si vous vous connectez à l’instance Microsoft Dynamics CRM Online :

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

      Notes

      Pour le paramètre DeploymentRegion, les valeurs valides sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan et NorthAmerica2. Pour le paramètre OnlineType les valeurs pouvant être utilisées sont Office365 et LiveID.

    • Si vous vous connectez au serveur Dynamics 365 en utilisant l’authentification basée sur les revendications auprès du domaine d’accueil spécifié :

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

  3. Les informations d'identification fournies sont validées lorsque vous exécutez la commande à l'étape 2. Une fois que l'exécution de la commande s’est déroulée correctement, tapez la commande suivante et appuyez sur ENTRÉE pour afficher les organisations auxquelles vous avez accès :

    $CRMOrgs

    Liste des organisations retournées par l'applet de commande

    Conseil

    Vous pouvez utiliser la variable utilisée pour stocker les organisations Dynamics 365 récupérées (ici $CRMOrgs) avec l’applet de commande Get-CrmConnection pour vous connecter à Dynamics 365. Pour spécifier le nom de l’organisation, utilisez la commande suivante : $CRMOrgs.UniqueName.

    S’il y a plus d’une valeur d’organisation stockée dans la variable $CRMOrgs, vous pouvez faire référence à l’organisation nth en utilisant la commande suivante : $CRMOrgs[n-1]. Par exemple, pour faire référence au nom unique de la troisième organisation de la variable $CRMOrgs (« MyOrg »), utilisez la commande suivante : $CRMOrgs[2].UniqueName.Pour plus d'informations :TechNet : Accès aux valeurs dans un tableau

Utiliser l’applet de commande pour se connecter à CRM

Utilisez l’applet de commande Get-CrmConnection pour vous connecter à une instance Dynamics 365. L’applet de commande vous permet d’utiliser le contrôle de connexion commun aux outils XRM pour spécifier vos informations d’identification et vous connecter à Dynamics 365 ou de spécifier vos informations d’identification en tant que paramètres inclus.Pour plus d'informations :Utiliser le contrôle commun de connexion de l’outil XRM dans vos applications clientes

Se connecter à CRM à l’aide du contrôle commun de connexion

  1. Si vous souhaitez utiliser le contrôle de connexion commun pour fournir vos informations d’identification et vous connecter à Dynamics 365, utilisez la commande suivante. Les informations de connexion sont stockées dans la variable $CRMConn afin que vous puissiez les utiliser ultérieurement.

    $CRMConn = Get-CrmConnection -InteractiveMode

  2. La boîte de dialogue Contrôle de connexion apparaît. Fournissez vos informations d’identification pour vous connecter à votre instance Dynamics 365, puis cliquez sur Connexion.

Se connecter à CRM en spécifiant les informations d’identification incluses

  1. Pour vous connecter à CRM, utilisez les commandes suivantes. Notez que ces commandes utilisent la variable $Cred créée précédemment pour stocker les informations d’authentification lors de la récupération des organisations. Les informations de connexion sont stockées dans la variable $CRMConn :

    • Si vous vous connectez au serveur Microsoft Dynamics CRM (local) :

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

    • Si vous vous connectez à l’instance Microsoft Dynamics CRM Online :

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

      Notes

      Pour le paramètre DeploymentRegion, les valeurs valides sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, Japan et NorthAmerica2. Pour le paramètre OnlineType les valeurs pouvant être utilisées sont Office365 et LiveID.

    • Si vous vous connectez au serveur Dynamics 365 en utilisant l’authentification basée sur les revendications auprès du domaine d’accueil spécifié :

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

    Notes

    Pour le paramètre OrganizationName de toutes les commandes précédentes, vous pouvez spécifier le nom unique ou le nom convivial de l’organisation. Vous pouvez également utiliser le nom unique ou le nom convivial que vous avez récupéré avec l’applet de commande Get-CrmOrganizations et stocké dans la variable $CRMOrgs. Par exemple, vous pouvez utiliser $CRMOrgs[x].UniqueName ou $CRMOrgs[x].FriendlyName.

  2. Les informations d'identification fournies sont validées lorsque vous exécutez la commande à l'étape 2. Une fois que l'exécution de l'applet de commande s’est déroulée correctement, tapez la commande suivante et appuyez sur ENTRÉE pour afficher les organisations auxquelles vous avez accès :

    $CRMConn

    informations et statut de connexion CRM

Voir aussi

Utiliser les outils XRM pour se connecter à CRM
Créer des applications clientes Windows à l’aide des outils XRM

© 2017 Microsoft. Tous droits réservés. Copyright