Partager via

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

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

Configuration requise

Enregistrer les applets de commande

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

Utiliser l'applet de commande pour se connecter au serveur Dynamics 365

Configuration requise

  • Pour utiliser les applets de commande pour les outils XRM, vous avez besoin de la version 3.0 de PowerShell ou ultérieure. 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 Dynamics 365

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 Dynamics 365 (local) ou Microsoft Dynamics 365 (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 Dynamics 365 (local) :

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

    • Si vous vous connectez à l’instance Microsoft Dynamics 365 (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, JPN, CAN, IND et NorthAmerica2. Pour le paramètre OnlineType, spécifiez Office365.

    • 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 deuxième organisation de la variable $CRMOrgs (« SampleOrg »), utilisez la commande suivante : $CRMOrgs[1].UniqueName.Pour plus d'informations :TechNet : Accès aux valeurs dans un tableau

Utiliser l'applet de commande pour se connecter au serveur Dynamics 365

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 à Dynamics 365 à 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 à Dynamics 365 en spécifiant les informations d’identification incluses

  1. Pour vous connecter à Dynamics 365, 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 Dynamics 365 (local) :

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

    • Si vous vous connectez à l’instance Microsoft Dynamics 365 (Online) :

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

      Notes

      Pour le paramètre DeploymentRegion, les valeurs valides sont : NorthAmerica, EMEA, APAC, SouthAmerica, Oceania, JPN, CAN, IND et NorthAmerica2. Pour le paramètre OnlineType, spécifiez Office365.

    • 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 1. 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 constructeurs CrmServiceClient pour se connecter à Dynamics 365
Créer des applications clientes Windows à l’aide des outils XRM
Blog : module PowerShell pour effectuer des opérations de données et gérer l'utilisateur et les paramètres système dans CRM

Microsoft Dynamics 365

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