Partager via

Utiliser les applets de commande PowerShell de déploiement centralisé pour gérer les compléments

  • Article

En tant qu’administrateur d’utilisateurs Microsoft 365, vous pouvez déployer des compléments Office pour les utilisateurs via la fonctionnalité Déploiement centralisé (voir Déployer des compléments Office dans le Centre d’administration). En plus de déployer des compléments Office via le Centre d’administration Microsoft 365, vous pouvez également utiliser Microsoft PowerShell. Installez le module de déploiement Add-In centralisé O365 pour Windows PowerShell.

Après avoir téléchargé le module, ouvrez une fenêtre Windows PowerShell standard et exécutez l’applet de commande suivante :

 Import-Module -Name O365CentralizedAddInDeployment

Se connecter à l’aide de vos informations d’identification d’administrateur

Avant de pouvoir utiliser les applets de commande de déploiement centralisé, vous devez vous connecter.

  1. Démarrez PowerShell.

  2. Connectez-vous à PowerShell à l’aide de vos informations d’identification d’administrateur utilisateur. Exécutez l’applet de commande suivante.

Connect-OrganizationAddInService
  1. Dans l’invite de connexion qui s’ouvre, sélectionnez ou entrez vos informations d’identification d’administrateur d’utilisateur Microsoft 365.

Remarque

Pour plus d’informations sur l’utilisation de PowerShell, consultez Se connecter à Microsoft 365 avec PowerShell.

Charger un manifeste de complément

Exécutez l’applet de commande New-OrganizationAdd-In pour charger un manifeste de complément à partir d’un chemin d’accès, qui peut être un emplacement de fichier ou une URL. L’exemple suivant montre un emplacement de fichier pour la valeur du paramètre ManifestPath .

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

Vous pouvez également exécuter l’applet de commande New-OrganizationAdd-In pour charger un complément et l’affecter à des utilisateurs ou des groupes directement à l’aide du paramètre Members , comme illustré dans l’exemple suivant. Séparez les adresses e-mail des membres par une virgule.

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members  'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'

Charger un complément à partir de l’Office Store

Exécutez l’applet de commande New-OrganizationAddIn pour charger un manifeste à partir de l’Office Store.

Dans l’exemple suivant, l’applet de commande New-OrganizationAddIn spécifie l’AssetId d’un complément pour un emplacement et un marché de contenu aux États-Unis.

New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'

Pour déterminer la valeur du paramètre AssetId , vous pouvez la copier à partir de l’URL de la page web de l’Office Store pour le complément. Les AssetIds commencent toujours par « WA » suivi d’un nombre. Par exemple, dans l’exemple précédent, la source de la valeur AssetId de WA104099688 est l’URL de la page web de l’Office Store pour le complément : https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Les valeurs des paramètres Régionaux et ContentMarket sont identiques et indiquent le pays/la région à partir duquel vous essayez d’installer le complément. Le format est en-US, fr-FR, etc.

Remarque

Les compléments chargés à partir de l’Office Store seront automatiquement mis à jour dans les quelques jours suivant la mise à jour la plus récente sur l’Office Store.

Obtenir les détails d’un complément

Exécutez l’applet de commande Get-OrganizationAddIn comme indiqué ci-dessous pour obtenir les détails de tous les compléments chargés sur le locataire, y compris l’ID de produit d’un complément.

Get-OrganizationAddIn

Exécutez l’applet de commande Get-OrganizationAddIn avec une valeur pour le paramètre ProductId afin de spécifier le complément pour lequel vous souhaitez récupérer les détails.

Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

Pour obtenir des détails complets sur tous les compléments, ainsi que sur les utilisateurs et les groupes affectés, dirigez la sortie de l’applet de commande Get-OrganizationAddIn vers l’applet de commande Format-List, comme illustré dans l’exemple suivant.

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}

Activer ou désactiver un complément

Pour désactiver un complément afin que les utilisateurs et les groupes qui lui sont affectés n’aient plus accès, exécutez l’applet de commande Set-OrganizationAddIn avec le paramètre ProductId et le paramètre Enabled défini sur $false, comme illustré dans l’exemple suivant.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false

Pour réactiver un complément, exécutez la même applet de commande avec le paramètre Enabled défini sur $true.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true

Ajouter ou supprimer des utilisateurs d’un complément

Pour ajouter des utilisateurs et des groupes à un complément spécifique, exécutez l’applet de commande Set-OrganizationAddInAssignments avec les paramètres ProductId, Add et Members . Séparez les adresses e-mail des membres par une virgule.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'

Pour supprimer des utilisateurs et des groupes, exécutez la même applet de commande à l’aide du paramètre Remove .

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'

Pour affecter un complément à tous les utilisateurs sur le locataire, exécutez la même applet de commande à l’aide du paramètre AssignToEveryone avec la valeur définie sur $true.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true

Pour ne pas affecter de complément à tout le monde et revenir aux utilisateurs et groupes précédemment affectés, vous pouvez exécuter la même applet de commande et désactiver le paramètre AssignToEveryone en définissant sa valeur sur $false.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false

Mettre à jour un complément

Pour mettre à jour un complément à partir d’un manifeste, exécutez l’applet de commande Set-OrganizationAddIn avec les paramètres ProductId, ManifestPath et Paramètres régionaux , comme indiqué dans l’exemple suivant.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

Remarque

Les compléments chargés à partir de l’Office Store seront automatiquement mis à jour dans les quelques jours suivant la mise à jour la plus récente sur l’Office Store.

Suppression d’un complément

Pour supprimer un complément, exécutez l’applet de commande Remove-OrganizationAddIn avec le paramètre ProductId , comme illustré dans l’exemple suivant.

Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

Obtenir une aide détaillée pour chaque applet de commande

Vous pouvez consulter une aide détaillée pour chaque applet de commande à l’aide de l’applet de commande Get-help. Par exemple, l’applet de commande suivante fournit des informations détaillées sur l’applet de commande Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full