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

En tant qu’administrateur Office 365, vous pouvez déployer les compléments Office auprès des utilisateurs via la fonctionnalité de déploiement centralisé (voir Déployer des compléments Office dans le Centre d’administration Office 365). Outre le déploiement des compléments Office via le Centre d’administration Office 365, vous pouvez également utiliser Microsoft PowerShell. Téléchargez les cmdlets PowerShell de déploiement centralisé à partir du Centre de téléchargement Microsoft.

Que voulez-vous faire ?

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

Charger un fichier manifeste de complément

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

Obtenir les informations d’un complément

Activer ou désactiver un complément

Ajouter des utilisateurs à un complément ou en supprimer

Mettre à jour un complément

Supprimer un complément

Obtenir une aide détaillée pour chaque cmdlet

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

Avant d’utiliser les cmdlets de déploiement centralisé, vous devez vous connecter.

  1. Démarrez PowerShell.

  2. Connectez-vous à PowerShell à l’aide de vos informations d’identification d’entreprise. Exécutez la cmdlet suivante :

    Connect-OrganizationAddInService
  3. Dans la page Entrer les informations d’identification, entrez vos informations d’identification d’administrateur général Office 365. Vous pouvez également entrer vos informations d’identification directement dans la cmdlet.

    Exécutez la cmdlet spécifiant les informations d’identification d’administrateur de votre entreprise en tant qu’objet PSCredential.

    $secpasswd = ConvertTo-SecureString “MyPassword” -AsPlainText -Force
    $mycredentials = New-Object System.Management.Automation.PSCredential (“serviceaccount@contoso.com”, $secpasswd)
    Connect-OrganizationAddInService -Credential $mycredentials

Remarque : Pour plus d’informations sur l’utilisation de PowerShell, voir Se connecter à Office 365 PowerShell.

Charger un fichier manifeste de complément

Exécutez la cmdlet New-OrganizationAdd-In pour charger un manifeste de complément à partir d’un chemin d’accès, lequel peut correspondre à un emplacement ou une URL de fichier. 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 la cmdlet New-OrganizationAdd-In pour charger un complément et l’affecter à des utilisateurs ou des groupes directement à l’aide du paramètre Members, comme montré dans l’exemple suivant. Séparez les adresses de courrier 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 la cmdlet New-OrganizationAddIn pour charger un manifeste à partir de l’Office Store.

Dans l’exemple suivant, la cmdlet 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 Office Store pour le complément. Les AssetId commencent toujours par « WA » suivi d’un nombre. Par exemple, dans l’exemple précédent, la source de la valeur AssetId de WA104099688 correspond à l’URL de page web Office Store du complément : https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Les valeurs des paramètres Locale et ContentMarket sont identiques et indiquent le pays ou 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 sont mis à jour automatiquement quelques jours après la publication de la dernière mise à jour sur l’Office Store.

Obtenir les informations d’un complément

Exécutez la cmdlet Get-OrganizationAddIn comme indiqué ci-dessous pour obtenir les informations de tous les compléments chargés sur le client, y compris l’ID de produit des compléments.

Get-OrganizationAddIn

Exécutez la cmdlet Get-OrganizationAddIn avec une valeur pour le paramètre ProductId pour spécifier le complément dont vous voulez récupérer les informations.

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

Pour obtenir les informations complètes de tous les compléments, ainsi que les utilisateurs et groupes affectés, canalisez la sortie de la cmdlet Get-OrganizationAddIn vers la cmdlet Format-List, comme montré dans l’exemple suivant.

Get-OrganizationAddIn |Format-List

Activer ou désactiver un complément

Pour désactiver un complément afin que les utilisateurs et groupes qui lui sont affectés n’y aient plus accès, exécutez la cmdlet Set-OrganizationAddIn avec les paramètres ProductId et Enabled définis sur la valeur $false, comme montré 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 cmldet avec le paramètre Enabled défini sur la valeur $true.

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

Ajouter des utilisateurs à un complément ou en supprimer

Pour ajouter des utilisateurs et groupes à un complément spécifique, exécutez la cmdlet Set-OrganizationAddInAssignments avec les paramètres ProductId, Add et Members. Séparez les adresses de courrier 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 cmdlet à 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 client, exécutez la cmdlet à 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 un complément à tout le monde et revenir aux utilisateurs et groupes précédemment affectés, vous pouvez exécuter la même cmdlet 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 la cmdlet Set-OrganizationAddIn avec les paramètres ProductId, ManifestPath et Locale, comme montré 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 sont mis à jour automatiquement quelques jours après la publication de la dernière mise à jour sur l’Office Store.

Supprimer un complément

Pour supprimer un complément, exécutez la cmdlet Remove-OrganizationAddIn avec le paramètre ProductId, comme montré dans l’exemple suivant.

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

Obtenir une aide détaillée pour chaque cmdlet

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

Get-help Remove-OrganizationAddIn -Full
Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×