Partager via


Set-AzureADUserLicense

Ajoute ou supprime des licences pour un service en ligne Microsoft à la liste des licences attribuées pour un utilisateur.

Notes

L’applet de commande Set-AzureADUserLicense 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-AzureADUserLicense
   -ObjectId <String>
   -AssignedLicenses <AssignedLicenses>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Set-AzureADUserLicense ajoute ou supprime des licences pour un service en ligne Microsoft à la liste des licences attribuées pour un utilisateur.

Exemples

Exemple 1 : Ajouter une licence à un utilisateur basé sur un utilisateur de modèle

PS C:\> $LicensedUser = Get-AzureADUser -ObjectId "TemplateUser@contoso.com"  
PS C:\> $User = Get-AzureADUser -ObjectId "User@contoso.com"  
PS C:\> $License = New-Object -TypeName Microsoft.Open.AzureAD.Model.AssignedLicense 
PS C:\> $License.SkuId = $LicensedUser.AssignedLicenses.SkuId 
PS C:\> $Licenses = New-Object -TypeName Microsoft.Open.AzureAD.Model.AssignedLicenses 
PS C:\> $Licenses.AddLicenses = $License 
PS C:\> Set-AzureADUserLicense -ObjectId $User.ObjectId -AssignedLicenses $Licenses

La première commande obtient un utilisateur à l’aide de l’applet de commande Get-AzureADUser , puis le stocke dans la variable $LicensedUser.

La deuxième commande obtient un autre utilisateur à l’aide de Get-AzureADUser, puis le stocke dans la variable $User.

La troisième commande crée un type AssignedLicense , puis le stocke dans la variable $License.

La quatrième commande définit la propriété SkuId de $License sur la même valeur que la propriété SkuId de $LicensedUser.

La cinquième commande crée un objet AssignedLicenses et le stocke dans la variable $Licenses.

La sixième commande ajoute la licence dans $License à $Licenses.

La commande finale attribue les licences dans $Licenses à l’utilisateur dans $User. Les licences dans $Licenses incluent $License des troisième et quatrième commandes.

Paramètres

-AssignedLicenses

Spécifie une liste de licences à attribuer ou à supprimer.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’informations. Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Inquire
  • SilentlyContinue
  • Arrêter
  • Interrompre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’information.

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

-ObjectId

Spécifie l’ID d’un utilisateur (en tant qu’UPN ou ObjectId) dans Azure AD.

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