Utiliser les applets de commande PowerShell de déploiement centralisé pour gérer les compléments
En tant qu’administrateur général 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 de 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.
Démarrez PowerShell.
Connectez-vous à PowerShell à l’aide des informations d’identification de l’administrateur de votre entreprise. Exécutez l’applet de commande suivante.
Connect-OrganizationAddInService
- Dans l’invite de connexion qui s’ouvre, sélectionnez ou entrez vos informations d’identification microsoft 365 User Administration ou Administrateur général.
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 États-Unis emplacement et le marché du contenu.
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour