Set-AzureADUserLicense

  • Referenz
Modul:
AzureAD

Fügt lizenzen für einen Microsoft-Onlinedienst der Liste der zugewiesenen Lizenzen für einen Benutzer hinzu oder entfernt sie.

Hinweis

Das Cmdlet Set-AzureADUserLicense ist veraltet. Erfahren Sie , wie Sie Lizenzen mit Microsoft Graph PowerShell zuweisen. Weitere Informationen finden Sie unter Microsoft Graph-API Lizenz zuweisen.

Syntax

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

Beschreibung

Die Set-AzureADUserLicense fügt Lizenzen für einen Microsoft-Onlinedienst der Liste der zugewiesenen Lizenzen für einen Benutzer hinzu oder entfernt sie.

Beispiele

Beispiel 1: Hinzufügen einer Lizenz zu einem Benutzer basierend auf einem Vorlagenbenutzer

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

Der erste Befehl ruft einen Benutzer mithilfe des Cmdlets Get-AzureADUser (./Get-AzureADUser.md) ab und speichert ihn dann in der variablen $LicensedUser.

Der zweite Befehl ruft einen anderen Benutzer mithilfe von Get-AzureADUser ab und speichert ihn dann in der variablen $User.

Der dritte Befehl erstellt einen AssignedLicense-Typ und speichert ihn dann in der variablen $License.

Der vierte Befehl legt die SkuId-Eigenschaft von $License auf den gleichen Wert wie die SkuId-Eigenschaft von $LicensedUser fest.

Der fünfte Befehl erstellt ein AssignedLicenses-Objekt und speichert es in der variablen $Licenses.

Der sechste Befehl fügt die Lizenz in $License zu $Licenses hinzu.

Der letzte Befehl weist dem Benutzer die Lizenzen in $Licenses in $User zu. Die Lizenzen in $Licenses enthalten $License aus dem dritten und vierten Befehl.

Parameter

-AssignedLicenses

Gibt eine Liste von Lizenzen an, die zugewiesen oder entfernt werden sollen.

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert. Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Diagnosetool
  • SilentlyContinue
  • Beenden
  • Angehalten
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Gibt eine Informationsvariable an.

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

-ObjectId

Gibt die ID eines Benutzers (als UPN oder ObjectId) in Azure AD an.

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

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für Set-AzureADUserLicense zu Microsoft Graph PowerShell.