Set-MsolUserLicense

  • Referenz
Modul:
MSOnline

Aktualisierungen die Lizenzzuweisung für einen Benutzer.

Hinweis

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

Syntax

Set-MsolUserLicense
   -ObjectId <Guid>
   [-LicenseOptions <LicenseOption[]>]
   [-AddLicenses <String[]>]
   [-RemoveLicenses <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Set-MsolUserLicense
   [-LicenseOptions <LicenseOption[]>]
   -UserPrincipalName <String>
   [-AddLicenses <String[]>]
   [-RemoveLicenses <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-MsolUserLicense aktualisiert die Lizenzzuweisung für einen Benutzer. Dazu gehören das Hinzufügen einer neuen Lizenz, das Entfernen einer Lizenz, das Aktualisieren von Lizenzaktionen sowie Kombinationen dieser Aktionen.

Beispiele

Beispiel 1: Hinzufügen einer Lizenz zu einem Benutzer

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "Contoso:ENTERPRISEPACK"

Dieser Befehl fügt dem Benutzer die Office 365 für Unternehmen-Lizenz hinzu.

Beispiel 2: Entfernen einer Lizenz aus einem Benutzer

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -RemoveLicenses "contoso:ENTERPRISEPACK"

Dieser Befehl entfernt die Office 365 für Unternehmen-Lizenz vom Benutzer. Dies kann zur Folge haben, dass die Daten des Benutzers aus jedem Dienst entfernt werden.

Beispiel 3: Ersetzen einer Lizenz durch eine andere

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "contoso:DESKLESS" -RemoveLicenses "contoso:ENTERPRISEPACK"

Dieser Befehl ersetzt die Office 365 for Enterprises-Lizenz durch eine Office 365 Deskless-Lizenz. Diese Änderungen werden in einem einzigen Vorgang vorgenommen. Daher endet der Benutzer nicht in einem Zwischenzustand, in dem die Office 365 for Enterprises-Lizenz entfernt wird, ohne dass Office 365 Deskless hinzugefügt wird.

Parameter

-AddLicenses

Gibt ein Array von Lizenzen an, die dem Benutzer zugewiesen werden sollen.

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

-LicenseOptions

Gibt ein Array von Lizenz- oder SKU-spezifischen Einstellungen an. Wird verwendet, um einzelne Dienste beim Zuweisen einer Lizenz zu deaktivieren.

Type:LicenseOption[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

Gibt die eindeutige Objekt-ID des Benutzers an, für die Lizenzen aktualisiert werden sollen.

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

-RemoveLicenses

Gibt ein Array von Lizenzen an, die vom Benutzer entfernt werden sollen.

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

-TenantId

Gibt die eindeutige ID des Mandanten an, auf der der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandanten des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

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

-UserPrincipalName

Gibt den Benutzernamen des zu aktualisierenden Benutzers an.

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