Partager via


Set-MsolUserLicense

Met à jour l’attribution de licence pour un utilisateur.

Notes

L’applet de commande Set-MsolUserLicense est déconseillée. Découvrez comment attribuer des licences avec Microsoft Graph PowerShell. Pour plus d’informations, consultez Attribuer une licence à l’API Microsoft Graph.

Syntaxe

Set-MsolUserLicense
   -ObjectId <Guid>
   [-LicenseOptions <LicenseOption[]>]
   [-AddLicenses <String[]>]
   [-RemoveLicenses <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Set-MsolUserLicense
   [-LicenseOptions <LicenseOption[]>]
   -UserPrincipalName <String>
   [-AddLicenses <String[]>]
   [-RemoveLicenses <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

L’applet de commande Set-MsolUserLicense met à jour l’attribution de licence pour un utilisateur. Les tâches de gestion possibles sont les suivantes : ajout d’une nouvelle licence, retrait d’une licence et mise à jour des options de licence.

Exemples

Exemple 1 : Ajouter une licence à un utilisateur

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "Contoso:ENTERPRISEPACK"

Cette commande ajoute la licence Office 365 pour entreprises à l’utilisateur.

Exemple 2 : Supprimer une licence d’un utilisateur

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -RemoveLicenses "contoso:ENTERPRISEPACK"

Cette commande supprime la licence Office 365 pour entreprises de l’utilisateur. Cela peut entraîner la suppression des données de l'utilisateur de chaque service.

Exemple 3 : Remplacer une licence par une autre

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "contoso:DESKLESS" -RemoveLicenses "contoso:ENTERPRISEPACK"

Cette commande remplace la licence Office 365 pour entreprises par une licence Office 365 Deskless. Ces modifications sont effectuées en une seule opération. Par conséquent, l’utilisateur ne se retrouve pas dans un état intermédiaire où la licence Office 365 pour entreprises est supprimée sans qu’Office 365 Deskless soit ajouté.

Paramètres

-AddLicenses

Spécifie un tableau de licences à attribuer à l’utilisateur.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LicenseOptions

Spécifie un tableau de paramètres spécifiques à la licence ou à la référence SKU. Permet de désactiver des services individuels lors de l’attribution d’une licence.

Type:LicenseOption[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ObjectId

Spécifie l’ID d’objet unique de l’utilisateur pour lequel mettre à jour les licences.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-RemoveLicenses

Spécifie un tableau de licences à supprimer de l’utilisateur.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-TenantId

Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-UserPrincipalName

Spécifie le nom d’utilisateur principal de l’utilisateur à mettre à jour.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False