Administration du déploiement à l’aide de Windows PowerShell

  • Article

 

Date de publication : janvier 2017

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

Avec Windows PowerShell, vous pouvez facilement exécuter des commandes de déploiement pour modifier la configuration de votre déploiement, telles que les tâches qui peuvent être effectuées via l'interface utilisateur du Gestionnaire de déploiement. Vous pouvez également utiliser les méthodes décrites dans le SDK de Microsoft Dynamics 365 pour réaliser ces tâches. Les applets de commande PowerShell sont installées sur l'ordinateur lorsque vous installez un rôle serveur complet ou lorsque vous installez le rôle serveur Outils de déploiement, si vous installez des rôles serveur spécifiques. Pour exécuter des commandes, vous devez d'abord enregistrer les commandes Microsoft Dynamics 365 avec PowerShell. Cette rubrique décrit comment procéder, ainsi que les tâches supplémentaires pour vous aider à utiliser PowerShell.

Recherchez l'aide sur les applets de commande PowerShell pour Microsoft Dynamics 365 dans Référence PowerShell Microsoft Dynamics CRM.

Pour plus d'informations sur l'utilisation de PowerShell, voir Génération de scripts avec Windows PowerShell.

Pour plus d'informations sur l'utilisation en programmation de Service Web de déploiement, voir MSDN : administrer le déploiement à l'aide du service Web de déploiement.

Contenu de la rubrique

Commencer à utiliser les applets de commande Dynamics 365 PowerShell

Utilisation des applets de commande PowerShell

Définition des propriétés à l'aide des applets de commande PowerShell

Accéder aux rubriques d'aide pour les applets de commande Dynamics 365 PowerShell

Mettre à jour les paramètres de configuration du déploiement à l'aide de PowerShell

Commencer à utiliser les applets de commande Dynamics 365 PowerShell

Enregistrer les applets de commande

  1. Connectez-vous au compte administrateur sur votre serveur Microsoft Dynamics 365.

  2. Ouvrez une invite de commandes PowerShell.

  3. Entrez la commande suivante.

    Add-PSSnapin Microsoft.Crm.PowerShell

    Cette commande permet d’ajouter le composant logiciel enfichable de Dynamics 365PowerShell dans la session active. Le composant logiciel enfichable est enregistré au cours de l'installation et de la configuration du serveur Microsoft Dynamics 365.

Important

  • Pour plus d'informations sur l'enregistrement des applets de commande du connecteur d'outils XRM, Get-CrmConnection et Get-CrmOrganizations, voir MSDN : Utiliser les applets de commande PowerShell pour que les outils XRM se connectent à CRM.

  • Pour plus d'informations sur l'enregistrement des applets de commande de Package Deployer, voir Déployer des packages avec Dynamics CRM Package Deployer et Windows PowerShell.

  • Vous devez enregistrer les commandes Dynamics 365PowerShell, sinon, le message suivant risque de s'afficher lorsque vous essayez d'exécuter une applet de commande.

    Le terme « Microsoft Dynamics 365 Windows PowerShell command » n'est pas reconnu comme nom d'applet de commande, fonction, fichier de script ou programme exécutable. Vérifiez l'orthographe du nom, ou si un chemin d'accès existe, vérifiez que le chemin d'accès est correct et réessayez.

Obtenir la liste des applets de commande Dynamics 365

  • À l'invite PowerShell, tapez ce qui suit :

    Get-Help *Crm*

Obtenir de l'aide sur une applet de commande

  • À l'invite PowerShell, tapez ce qui suit, en remplaçant CrmCmdletName par le nom d'une commande.

    Get-Help CrmCmdletName

Pour obtenir de l'aide détaillée pour une applet de commande spécifique, utilisez une Get-Help CRMCmdlet–full, comme l'applet de commande Import-CRMOrganization.

Get-Help Import-CRMOrganization -full

Utilisation des applets de commande PowerShell

Une fois que vous avez enregistré les commandes Dynamics 365PowerShell, vous pouvez les utiliser pour effectuer des tâches.

Utilisez la commande suivante pour produire la liste des administrateurs de déploiement.

PS C:\Users\Administrator> Get-CrmDeploymentAdministrator

Cette commande entraîne la sortie suivante.

ID

Nom

ExtensionData

--

----

-------------

4f431656-90f8-e211-831c-00155da83c4f

myDomainName\Administrateur

Définition des propriétés à l'aide des applets de commande PowerShell

Une fois que vous avez enregistré les commandes Microsoft Dynamics 365PowerShell, vous pouvez les utiliser pour effectuer des tâches, telles que la définition des propriétés du déploiement ou des propriétés d'organisation.

Par exemple, pour ajouter un administrateur de déploiement Microsoft Dynamics 365, exécutez la commande suivante où domain\adminName représente le domaine Active Directory et le nom d'utilisateur de l'administrateur à ajouter.

New-CrmDeploymentAdministrator domain\adminName

Accéder aux rubriques d'aide pour les applets de commande Dynamics 365 PowerShell

Pour obtenir la liste complète des applets de commande PowerShell pour Microsoft Dynamics 365 avec les liens vers les rubriques d'aide, voir la Référence Powershell pour Microsoft Dynamics CRM.

Mettre à jour les paramètres de configuration du déploiement à l'aide de PowerShell

Utilisez PowerShell pour mettre à jour les paramètres valides pour tout le déploiement, comme l'authentification basée sur les revendications, le déploiement avec accès via Internet (IFD) et les adresses Web.Pour plus d'informations :Mettre à jour les paramètres de configuration du déploiement

Voir aussi

Mettre à jour les paramètres de configuration du déploiement
Exploitation de Microsoft Dynamics 365

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