Freigeben über


New-AzADUser

Fügt benutzern neue Entität hinzu

Syntax

New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   -Password <SecureString>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   [-ForceChangePasswordNextLogin]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   -PasswordProfile <IMicrosoftGraphPasswordProfile>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Fügt benutzern neue Entität hinzu

Beispiele

Beispiel 1: Erstellen eines Benutzers mit Kennwortprofil

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Erstellen eines Benutzers mit Kennwortprofil

Beispiel 2: Erstellen eines Benutzers mit Kennwort

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Erstellen eines Benutzers mit Kennwort

Parameter

-AboutMe

Ein Freihandform-Texteingabefeld, das der Benutzer selbst beschreiben kann. Wird nur für $select zurückgegeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AccountEnabled

true für die Aktivierung des Kontos; andernfalls "false".

Typ:Boolean
Aliase:EnableAccount
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Birthday

Der Geburtstag des Benutzers. Der Timestamp-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 ist z. B. 2014-01-01T00:00:00Z nur für $select zurückgegeben.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CompanyName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConsentProvidedForMinor

Legt fest, ob die Zustimmung für Minderjährige erhalten 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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:PSObject
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeletedDateTime

.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceEnrollmentLimit

Der Grenzwert für die maximale Anzahl von Geräten, die der Benutzer registrieren darf. Zulässige Werte sind 5 oder 1000.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Der im Adressbuch für den Benutzer angezeigte Name. Dieser Wert ist in der Regel die Kombination aus vornamen, mittlerem Anfangs- und Nachname des Benutzers. 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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EmployeeId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EmployeeType

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExternalUserStateChangeDateTime

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

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FaxNumber

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GivenName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HireDate

Das Einstellungsdatum des Benutzers. Der Timestamp-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Wird nur für $select zurückgegeben. Hinweis: Diese Eigenschaft ist spezifisch für SharePoint Online. Es wird empfohlen, die native EmployeeHireDate-Eigenschaft zum Festlegen und Aktualisieren von Einstellungsdatumswerten mithilfe von Microsoft Graph-APIs zu verwenden.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImmutableId

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)..

Typ:String
Aliase:OnPremisesImmutableId
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Interest

Eine Liste, in der der Benutzer seine Interessen beschreiben kann. Wird nur für $select zurückgegeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsResourceAccount

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobTitle

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Mail

Die SMTP-Adresse für den Benutzer, z admin@contoso.com. B. . Ä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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MailNickname

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MobilePhone

Die primäre Mobiltelefonnummer des Benutzers. Schreibgeschützt für Benutzer, die aus dem lokalen Verzeichnis synchronisiert wurden. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MySite

Die URL für die persönliche Website des Benutzers. Wird nur für $select zurückgegeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OfficeLocation

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Password

Kennwort für den Benutzer Sie muss die Anforderungen an die Kennwortkomplexität des Mandanten erfüllen. Es wird empfohlen, ein sicheres Kennwort festzulegen.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PasswordPolicy

Gibt 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).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PasswordProfile

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

Typ:IMicrosoftGraphPasswordProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PostalCode

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PreferredLanguage

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PreferredName

Der bevorzugte Name für den Benutzer. Wird nur für $select zurückgegeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Responsibility

Eine Liste, in der der Benutzer seine Zuständigkeiten aufzählt. Wird nur für $select zurückgegeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-School

Eine Liste, in der der Benutzer die schulen aufzählt, an denen sie teilgenommen haben. Wird nur für $select zurückgegeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Skill

Eine Liste, in der der Benutzer seine Fähigkeiten aufzählt. Wird nur für $select zurückgegeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-State

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StreetAddress

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Surname

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UsageLocation

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserPrincipalName

Der Benutzerprinzipalname (User Principal Name, UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetformat für den Benutzer basierend auf dem Internetstandard RFC 822. In der Konvention sollte dies dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobei die Domäne in der Sammlung der überprüften 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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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,).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

IMicrosoftGraphUser

Hinweise

ALIASE

KOMPLEXE PARAMETEREIGENSCHAFTEN

Um die unten beschriebenen Parameter zu erstellen, erstellen Sie eine Hashtabelle mit den entsprechenden Eigenschaften. Informationen zu Hashtabellen finden Sie unter "Get-Help about_Hash_Tables".

PASSWORDPROFILE <IMicrosoftGraphPasswordProfile>: passwordProfile

  • [(Any) <Object>]: Gibt an, dass jeder Eigenschaft zu diesem Objekt hinzugefügt werden kann.
  • [ForceChangePasswordNextSignIn <Boolean?>]: true, wenn der Benutzer sein Kennwort bei der nächsten Anmeldung ändern muss; andernfalls "false". Wenn sie nicht festgelegt ist, ist der Standardwert "false". HINWEIS: Legen Sie für Azure B2C-Mandanten auf "false" fest, und verwenden Sie stattdessen benutzerdefinierte Richtlinien und Benutzerflüsse, um die Kennwortzurücksetzung bei der ersten Anmeldung zu erzwingen. Siehe "Erzwingen der Kennwortzurücksetzung bei der ersten Anmeldung".
  • [ForceChangePasswordNextSignInWithMfa <Boolean?>]: Wenn true, muss der Benutzer bei der nächsten Anmeldung eine mehrstufige Authentifizierung (Multi-Factor Authentication, MFA) durchführen, bevor er gezwungen wird, sein Kennwort zu ändern. Das Verhalten ist identisch mit forceChangePasswordNextSignIn, mit der Ausnahme, dass der Benutzer zuerst eine mehrstufige Authentifizierung vor der Kennwortänderung durchführen muss. Nach einer Kennwortänderung wird diese Eigenschaft automatisch auf "false" zurückgesetzt. Wenn sie nicht festgelegt ist, ist der Standardwert "false".
  • [Password <String>]: 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.