Set-AzureADUserLicense

  • Référence
Module:
AzureAD

Ajoute ou supprime des licences pour un service en ligne Microsoft à la liste des licences attribuées à 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 l’API Graph Attribuer une licence Microsoft.

Syntax

Set-AzureADUserLicense
   -ObjectId <String>
   -AssignedLicenses <AssignedLicenses>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Le 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 (./Get-AzureADUser.md), puis la 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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Notes

Consultez le guide de migration de Set-AzureADUserLicense vers Microsoft Graph PowerShell.