Set-MsolUserPrincipalName

  • Referenz
Modul:
MSOnline

Ändert die Benutzer-ID für einen Benutzer.

Syntax

Set-MsolUserPrincipalName
   -ObjectId <Guid>
   -NewUserPrincipalName <String>
   [-ImmutableId <String>]
   [-NewPassword <String>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Set-MsolUserPrincipalName
   -NewUserPrincipalName <String>
   [-ImmutableId <String>]
   [-NewPassword <String>]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Set-MsolUserPrincipalName " ändert den Benutzerprinzipalnamen oder die Benutzer-ID eines Benutzers. Dieses Cmdlet kann verwendet werden, um einen Benutzer zwischen einer Verbunddomäne und einer Standarddomäne zu verschieben, wodurch sich der Authentifizierungstyp in die der Zieldomäne ändert.

Beispiele

Beispiel 1: Umbenennen eines Benutzers

PS C:\> Set-MsolUserPrincipalName -UserPrincipalName "davidc@contoso.com" -NewUserPrincipalName "davidchew@contoso.com"

Dieser Befehl wird davidc@contoso.com in davidchew@contoso.com.

Parameter

-ImmutableId

Gibt die unveränderliche ID der Verbundidentität des Benutzers an. Dies ist erforderlich, wenn der Benutzer von einem Standard in eine Verbundidentitätsdomäne verschoben wird.

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

-NewPassword

Gibt das neue Kennwort für den Benutzer an. Dies ist erforderlich, wenn der Benutzer von einer Verbunddomäne in eine Standardidentitätsdomäne verschoben wird.

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

-NewUserPrincipalName

Gibt die neue Benutzer-ID des Benutzers an.

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

-ObjectId

Gibt die eindeutige Objekt-ID des zu aktualisierenden Benutzers an.

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

-TenantId

Gibt die eindeutige ID des Mandanten an, auf dem der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant 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 die ursprüngliche Benutzer-ID des zu aktualisierenden Benutzers an.

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