Freigeben über


Update-AzADUser

Aktualisiert entität in Benutzern

Syntax

UPNOrObjectIdParameterSet (Standard)

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Aktualisiert entität in Benutzern

Beispiele

Beispiel 1: Aktualisieren des Benutzers anhand des Benutzerprinzipalnamens

Update-AzADUser -UPNOrObjectId $upn -City $city

Benutzer nach Benutzerprinzipalname aktualisieren

Parameter

-AccountEnabled

true für die Aktivierung des Kontos; andernfalls "false". Immer wahr, wenn es in Kombination mit -Password. -AccountEnabled $false wird ignoriert, wenn das Kennwort des Kontos geändert wird.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:EnableAccount

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AgeGroup

Legt die Altersgruppe des Benutzers fest. Zulässige Werte: null, minor, notAdult und adult. Weitere Informationen finden Sie in den Gesetzlichen Altersklassen-Eigenschaftsdefinitionen. Unterstützt $filter (eq, ne, NOT und in).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-City

Die Stadt, in der sich der Benutzer befindet. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CompanyName

Der Firmenname, dem der Benutzer zugeordnet ist. Diese Eigenschaft kann nützlich sein, um die Firma zu beschreiben, aus der ein externer Benutzer kommt. Die maximale Länge des Firmennamens beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConsentProvidedForMinor

Legt fest, ob die Einverständniserklärung für Minderjährige eingeholt wurde. Zulässige Werte: NULL, gewährt, verweigert und nicht angefordert. Weitere Informationen finden Sie in den Gesetzlichen Altersklassen-Eigenschaftsdefinitionen. Unterstützt $filter (eq, ne, NOT und in).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Country

Das Land/die Region, in dem sich der Benutzer befindet; z. B. USA oder Uk. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeletedDateTime

.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Department

Der Name der Abteilung, in der der Benutzer arbeitet. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le und in Operatoren).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Der Name des Benutzers, der im Adressbuch angezeigt wird. Dieser Wert besteht normalerweise aus einer Kombination aus dem Vornamen, der Initiale des weiteren Vornamens und des Nachnamens. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird und während updates nicht gelöscht werden kann. Die maximale Länge beträgt 256 Zeichen. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy und $search.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EmployeeHireDate

Das Datum und die Uhrzeit, zu dem der Benutzer eingestellt wurde, oder beginnt bei einer zukünftigen Einstellung mit der Arbeit. Unterstützt $filter (eq, ne, NOT , ge, le, in).

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EmployeeId

Die Mitarbeiter-ID, die dem Benutzer von der Organisation zugewiesen wurde. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EmployeeType

Erfasst den Arbeitnehmertyp des Unternehmens. Beispiel: Mitarbeiter, Auftragnehmer, Berater oder Lieferant. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExternalUserState

Für einen externen Benutzer, der mit der Einladungs-API zum Mandanten eingeladen wurde, stellt diese Eigenschaft den Einladungsstatus des eingeladenen Benutzers dar. Für eingeladene Benutzer kann der Status "PendingAcceptance" oder "Accepted" oder "Null" für alle anderen Benutzer sein. Unterstützt $filter (eq, ne, NOT , in).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExternalUserStateChangeDateTime

Zeigt den Zeitstempel für die letzte Änderung an der externalUserState-Eigenschaft an. Unterstützt $filter (eq, ne, NOT , in).

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FaxNumber

Die Faxnummer des Benutzers. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForceChangePasswordNextLogin

Es muss angegeben werden, wenn der Benutzer das Kennwort bei der nächsten erfolgreichen Anmeldung (true) ändern muss. Das Standardverhalten ist (false), um das Kennwort bei der nächsten erfolgreichen Anmeldung nicht zu ändern.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GivenName

Der Vorname des Benutzers. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Schreibgeschützt

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Stellt die Identitäten dar, mit denen Sie sich bei diesem Benutzerkonto anmelden können. Eine Identität kann von Microsoft (auch als lokales Konto bezeichnet) von Organisationen oder von Sozialen Identitätsanbietern wie Facebook, Google und Microsoft bereitgestellt und an ein Benutzerkonto gebunden werden. Kann mehrere Elemente mit demselben signInType-Wert enthalten. Unterstützt $filter (eq) nur, wenn signInType nicht userPrincipalName ist. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für IDENTITÄTseigenschaften, und erstellen Sie eine Hashtabelle.

Parametereigenschaften

Typ:

IMicrosoftGraphObjectIdentity[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Benutzereingabeobjekt

Parametereigenschaften

Typ:IMicrosoftGraphUser
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

InputObjectParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsResourceAccount

Nicht verwenden – reserviert für die zukünftige Verwendung.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobTitle

Die Position des Benutzers. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Mail

SMTP-Adresse für den Benutzer, z. B. admin@contoso.com. Änderungen an dieser Eigenschaft aktualisieren auch die ProxyAddresses-Auflistung des Benutzers, um den Wert als SMTP-Adresse einzuschließen. Obwohl diese Eigenschaft Akzentzeichen enthalten kann, kann die Verwendung zu Zugriffsproblemen mit anderen Microsoft-Anwendungen für den Benutzer führen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MailNickname

Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ObjectId

Der Benutzerprinzipalname des zu aktualisierenden Benutzers.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ObjectIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OfficeLocation

Der Bürostandort der Firma des Benutzers Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnPremisesImmutableId

Diese Eigenschaft wird verwendet, um ihrem Azure AD-Benutzerobjekt ein lokales Active Directory-Benutzerkonto zuzuordnen. Diese Eigenschaft muss beim Erstellen eines neuen Benutzerkontos in Graph angegeben werden, wenn Sie eine Verbunddomäne für die UserPrincipalName (UPN)-Eigenschaft des Benutzers verwenden. HINWEIS: Die Zeichen $ und _ können nicht verwendet werden, wenn Sie diese Eigenschaft angeben. Wird nur für $select zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, in)..

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OtherMail

Eine Liste zusätzlicher E-Mail-Adressen für den Benutzer; Beispiel: ['bob@contoso.com,', 'Robert@fabrikam.com']. HINWEIS: Obwohl diese Eigenschaft Akzentzeichen enthalten kann, können sie Zugriffsprobleme auf Erstanbieteranwendungen für den Benutzer verursachen. Unterstützt $filter (eq, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt true zurück, wenn der Befehl erfolgreich ist.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Password

Das Kennwort für den Benutzer. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird.

Sie kann aktualisiert werden, aber der Benutzer muss das Kennwort bei der nächsten Anmeldung ändern.

Das Kennwort muss die Mindestanforderungen erfüllen, wie durch die PasswordPolicies-Eigenschaft des Benutzers angegeben. Standardmäßig ist ein sicheres Kennwort erforderlich. Wenn Sie das Kennwort mithilfe dieser Methode ändern, wird AccountEnabled auf "true" festgelegt.

Parametereigenschaften

Typ:SecureString
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PasswordPolicy

Gibt die Kennwortrichtlinien für den Benutzer an. Dieser Wert ist eine Aufzählung mit einem möglichen Wert, der DisableStrongPassword ist, wodurch schwächere Kennwörter als die Standardrichtlinie angegeben werden können. DisablePasswordExpiration kann auch angegeben werden. Die beiden können zusammen angegeben werden; Beispiel: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PasswordProfile

passwordProfile To construct, see NOTES section for PASSWORDPROFILE properties and create a hash table.

Parametereigenschaften

Typ:IMicrosoftGraphPasswordProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PostalCode

Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist für das Land/die Region des Benutzers spezifisch. In den USA enthält dieses Attribut den ZIP Code. Die maximale Länge beträgt 40 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PreferredLanguage

Die bevorzugte Sprache für den Benutzer. Sollte dem ISO 639-1-Code folgen; z. B. en-US. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ShowInAddressList

"true", wenn die globale Adressliste von Outlook diesen Benutzer enthalten soll, andernfalls "false". Wenn sie nicht festgelegt ist, wird dies als "true" behandelt. Für Benutzer, die über den Einladungs-Manager eingeladen wurden, wird diese Eigenschaft auf "false" festgelegt. Unterstützt $filter (eq, ne, NOT, in).

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-State

Bundesland oder Kanton in der Adresse des Benutzers. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StreetAddress

Die Straße der Firma des Benutzers. Die maximale Länge beträgt 1024 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Surname

Der Nachname des Benutzers. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UPNOrObjectId

Der Benutzerprinzipalname oder die Objekt-ID des Zu aktualisierenden Benutzers.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UPNOrObjectIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UsageLocation

Ein aus zwei Buchstaben bestehender Ländercode (ISO-Standard 3166). Erforderlich für Benutzer, denen Lizenzen zugewiesen werden, aufgrund der gesetzlichen Anforderung, die Verfügbarkeit von Diensten in Ländern zu überprüfen. Beispiele: US, JP und GB. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserPrincipalName

Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetstil für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konvention sollte er dem E-Mail-Namen des Benutzers zugeordnet sein. Das allgemeine Format lautet „alias@domäne“, wobei „domäne“ in der Sammlung der verifizierten Domänen des Mandanten vorhanden sein muss. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Auf die überprüften Domänen für den Mandanten kann über die verifiedDomains-Eigenschaft der Organisation zugegriffen werden. HINWEIS: Obwohl diese Eigenschaft Akzentzeichen enthalten kann, können sie Zugriffsprobleme auf Erstanbieteranwendungen für den Benutzer verursachen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) und $orderBy.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:UPN

Parametersätze

UPNParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserType

Ein Zeichenfolgenwert, der zum Klassifizieren von Benutzertypen in Ihrem Verzeichnis verwendet werden kann, z. B. "Mitglied" und "Gast". Unterstützt $filter (eq, ne, NOT, in,).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

IMicrosoftGraphUser

Ausgaben

Boolean

Hinweise

ALIASE

Set-AzADUser