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
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 $LicensesLa première commande obtient un utilisateur à l’aide de l’applet de commande Get-AzureADUser (./Get-AzureADUser.md), 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 |
Notes
Consultez le guide de migration pour Set-AzureADUserLicense vers Microsoft Graph PowerShell.