Condividi tramite


Set-AzureADUserLicense

Aggiunge o rimuove le licenze per un servizio online Microsoft all'elenco delle licenze assegnate per un utente.

Nota

Il cmdlet Set-AzureADUserLicense è deprecato. Informazioni su come assegnare licenze con Microsoft Graph PowerShell. Per altre informazioni, vedere l'API Assegna licenza Microsoft Graph.

Sintassi

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

Descrizione

L'Set-AzureADUserLicense aggiunge o rimuove le licenze per un servizio online Microsoft all'elenco delle licenze assegnate per un utente.

Esempio

Esempio 1: Aggiungere una licenza a un utente in base a un utente modello

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

Il primo comando ottiene un utente usando il cmdlet Get-AzureADUser (./Get-AzureADUser.md) e quindi lo archivia nella variabile $LicensedUser.

Il secondo comando ottiene un altro utente usando Get-AzureADUser e quindi lo archivia nella variabile $User.

Il terzo comando crea un tipo AssignedLicense e lo archivia nella variabile $License.

Il quarto comando imposta la proprietà SkuId di $License sullo stesso valore della proprietà SkuId di $LicensedUser.

Il quinto comando crea un oggetto AssignedLicenses e lo archivia nella variabile $Licenses.

Il sesto comando aggiunge la licenza in $License a $Licenses.

Il comando finale assegna le licenze in $Licenses all'utente in $User. Le licenze in $Licenses includono $License dal terzo e quarto comando.

Parametri

-AssignedLicenses

Specifica un elenco di licenze da assegnare o rimuovere.

Tipo:AssignedLicenses
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InformationAction

Specifica il modo in cui questo cmdlet risponde a un evento informativo. I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Verifica
  • SilentlyContinue
  • Arresto
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ObjectId

Specifica l'ID di un utente (come UPN o ObjectId) in Azure AD.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Note

Vedere la guida alla migrazione per Set-AzureADUserLicense su Microsoft Graph PowerShell.