Set-MsolUser
Ändert einen Benutzer in Azure Active Directory.
Syntax
Set-MsolUser
[-ImmutableId <String>]
[-ObjectId <Guid>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-TenantId <Guid>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-MsolUser ändert ein Benutzerobjekt.
Verwenden Sie dieses Cmdlet nur für Updates grundlegender Eigenschaften. Aktualisieren Sie die Lizenzen, das Kennwort und den Benutzerprinzipalnamen für einen Benutzer mithilfe der Cmdlets Set-MsolUserLicense, Set-MsolUserPassword und Set-MsolUserPrincipalName .
Beispiele
Beispiel 1: Blockieren von Anmeldeinformationen für einen Benutzer
PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -BlockCredential $TrueMit diesem Befehl werden Blockanmeldeinformationen auf $True für einen Benutzer festgelegt, wodurch die Anmeldung verhindert wird. Dies kann nicht für einen synchronisierten Benutzer erfolgen.
Beispiel 2: Aktualisieren des Anzeigenamens
PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -Title "Manager" -Department "Finance"Dieser Befehl aktualisiert den Anzeigenamen für den angegebenen Benutzer.
Beispiel 3: Festlegen des Speicherorts eines Benutzers
PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -UsageLocation "CA"Mit diesem Befehl wird das Land oder die Region eines Benutzers festgelegt. Das Land oder die Region muss ein ISO-Code aus zwei Buchstaben sein. und kann sowohl für synchronisierte als auch für verwaltete Benutzer festgelegt werden.
Beispiel 4: Festlegen des bevorzugten Datenspeicherorts
PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -PreferredDataLocation "EUR"Mit diesem Befehl wird die eigenschaft "bevorzugter Speicherort" eines Benutzers festgelegt, dessen Benutzerprinzipalname eur ist davidchew@contoso.com .
Parameter
-AlternateEmailAddresses
Gibt alternative E-Mail-Adressen für den Benutzer an.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-AlternateMobilePhones
Gibt alternative Mobiltelefonnummern für den Benutzer an.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-BlockCredential
Gibt an, ob sich der Benutzer nicht mit seiner Benutzer-ID anmelden kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-City
Gibt die Stadt des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Country
Gibt das Land oder die Region des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Department
Gibt die Abteilung des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DisplayName
Gibt den Anzeigenamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Fax
Gibt die Faxnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-FirstName
Gibt den Vornamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ImmutableId
Gibt die unveränderliche ID der Verbundidentität des Benutzers an. Dies sollte für Benutzer mit Standardidentitäten weggelassen werden.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-LastName
Gibt den Nachnamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-LastPasswordChangeTimestamp
Gibt einen Zeitpunkt an, zu dem das Kennwort zuletzt geändert wurde.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-MobilePhone
Gibt die Mobiltelefonnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ObjectId
Gibt die eindeutige Objekt-ID des Benutzers an.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Office
Gibt den Standort des Büros des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PasswordNeverExpires
Gibt an, ob das Benutzerkennwort in regelmäßigen Abständen abläuft.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PhoneNumber
Gibt die Telefonnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PostalCode
Gibt die Postleitzahl des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PreferredDataLocation
Gibt den bevorzugten Speicherort für den Benutzer an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PreferredLanguage
Gibt die bevorzugte Sprache des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-SoftDeletionTimestamp
Gibt einen Zeitpunkt für das vorläufige Löschen an.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-State
Gibt den Bundesstaat oder die Provinz an, in dem sich der Benutzer befindet.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StreetAddress
Gibt die Adresse des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StrongAuthenticationMethods
Gibt ein Array starker Authentifizierungsmethoden an.
| Typ: | StrongAuthenticationMethod[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StrongAuthenticationRequirements
Gibt ein Array mit starken Authentifizierungsanforderungen an.
| Typ: | StrongAuthenticationRequirement[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StrongPasswordRequired
Gibt an, ob ein sicheres Kennwort für den Benutzer erforderlich ist.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StsRefreshTokensValidFrom
Gibt einen StsRefreshTokensValidFrom-Wert an.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Title
Gibt den Titel des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-UsageLocation
Gibt den Speicherort des Benutzers an, an dem Dienste genutzt werden. Geben Sie einen zweistelligen Länder- oder Regionscode an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-UserPrincipalName
Gibt die Benutzer-ID des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-UserType
Gibt den Benutzertyp an.
| Typ: | UserType |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |