Get-MsolUser

Ruft Benutzer aus Azure Active Directory ab.

Syntax

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-MsolUser ruft einen einzelnen Benutzer oder eine Liste von Benutzern ab. Geben Sie den Parameter ObjectId oder UserPrincipalName an, um einen bestimmten Benutzer abzurufen.

Beispiele

Beispiel 1: Abrufen aller Benutzer

PS C:\> Get-MsolUser

Dieser Befehl ruft alle Benutzer im Unternehmen ab. Es wird bis zum Standardwert von 500 Ergebnissen angezeigt.

Beispiel 2: Abrufen aktivierter Benutzer

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

Dieser Befehl ruft bis zu 2000 aktivierte Benutzer ab.

Beispiel 3: Abrufen eines Benutzers nach UPN

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

Dieser Befehl ruft den Benutzer mit dem UPN davidchew@contoso.comab.

Beispiel 4: Abrufen eines Benutzers nach Objekt-ID

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

Dieser Befehl ruft einen Benutzer ab, der über die angegebene Objekt-ID verfügt.

Beispiel 5: Abrufen von Benutzern nach Suchzeichenfolge

PS C:\> Get-MsolUser -SearchString "David"

Dieser Befehl ruft eine Liste der Benutzer mit David im Anzeigenamen oder der E-Mail-Adresse ab.

Beispiel 6: Abrufen des bevorzugten Speicherorts eines Benutzers

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

Dieser Befehl gibt den bevorzugten Speicherort eines Benutzers zurück.

Parameter

-All

Gibt an, dass dieses Cmdlet alle Ergebnisse zurückgibt. Geben Sie nicht zusammen mit dem MaxResults-Parameter an .

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

-City

Gibt die Stadt an, nach der Ergebnisse gefiltert werden sollen.

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

-Country

Gibt das Land oder die Region an, nach dem die Ergebnisse gefiltert werden sollen.

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

-Department

Gibt die Abteilung an, nach der Ergebnisse gefiltert werden sollen.

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

-DomainName

Gibt die Domäne an, nach der Ergebnisse gefiltert werden sollen. Dies muss eine überprüfte Domäne für das Unternehmen sein. Alle Benutzer mit einer primären oder sekundären E-Mail-Adresse in dieser Domäne werden zurückgegeben.

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

-EnabledFilter

Gibt den Filter für aktivierte oder deaktivierte Benutzer an. Gültige Werte sind All, EnabledOnly und DisabledOnly.

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

-HasErrorsOnly

Gibt an, dass dieses Cmdlet nur Benutzer zurückgibt, die Überprüfungsfehler aufweisen.

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

-LicenseReconciliationNeededOnly

Gibt an, dass dieses Cmdlet nur für Benutzer filtert, die eine Lizenzabstimmung benötigen.

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

-MaxResults

Gibt die maximale Anzahl von Ergebnissen an, die dieses Cmdlet zurückgibt. Der Standardwert ist 500.

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

-ObjectId

Gibt die eindeutige Objekt-ID des abzurufenden Benutzers an.

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

-ReturnDeletedUsers

Gibt an, dass dieses Cmdlet nur Benutzer im Papierkorb zurückgibt.

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

-SearchString

Gibt eine Zeichenfolge an, die mit der E-Mail-Adresse oder dem Anzeigenamen ab dieser Zeichenfolge übereinstimmt.

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

-State

Gibt den Filter für den Status des Benutzers an.

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

-Synchronized

Gibt an, dass dieses Cmdlet nur Benutzer zurückgibt, die über die Azure Active Directory-Synchronisierung synchronisiert werden.

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

-TenantId

Gibt die eindeutige ID des Mandanten an, für den 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

Speicifiziert den Filter für den Titel des Benutzers.

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

-UnlicensedUsersOnly

Gibt an, dass dieses Cmdlet nur Benutzer zurückgibt, denen keine Lizenz zugewiesen ist.

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

-UsageLocation

Gibt den Filter für das Land oder die Region an, in dem die Dienste vom Benutzer genutzt werden. Geben Sie einen Zweibuchstaben-Länder- oder Regionscode an.

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

-UserPrincipalName

Gibt die Benutzer-ID des abzurufenden Benutzers aus.

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

Ausgaben

Microsoft.Online.Administration.User

Dieses Cmdlet gibt Benutzerobjekte zurück, die die folgenden Informationen enthalten:

  • AlternateEmailAddresses. Alternative E-Mail-Adresse des Benutzers (außerhalb von Azure Active Directory).

  • BlockCredential. Gibt an, ob sich der Benutzer anmelden kann.

  • City. Die Stadt des Benutzers.

  • Land/Region. Das Land oder die Region des Benutzers.

  • Abteilung. Die Abteilung des Benutzers.

  • DisplayName. Anzeigename des Benutzers.

  • Fehler. Ein Array von Fehlern. Dies sind Überprüfungsfehler, die zu einer Dienstunterbrechung führen können.

  • Fax. Die Faxnummer des Benutzers.

  • Firstname. Dies ist der Vorname des Benutzers.

  • ImmutableID. Wird nur für Partnerbenutzer zurückgegeben. Dies ist die ID, die für den Verbund mit Azure Active Directory erforderlich ist.

  • isBlackBerryUser. Gibt zurück, ob der Benutzer ein BlackBerry-Gerät nutzt.

  • isLicensed. Gibt an, ob dem Benutzer Lizenzen zugewiesen sind.

  • LastDirSyncTime. Das Datum und die Uhrzeit der letzten Verzeichnissynchronisierung (nur von Benutzern zurückgegeben, die mit Azure Active Directory über die Active Directory-Synchronisierung synchronisiert wurden).

  • LastPasswordChangeTimestamp. Der letzte Zeitpunkt, zu dem eine Kennwortänderung für den Benutzer in Azure Active Directory registriert wurde.

  • LastName. Dies ist der Nachname des Benutzers.

  • LicenseReconciliationNeeded. Gibt an, ob der Benutzer derzeit über ein Postfach ohne Lizenz verfügt. In diesem Fall sollte der Benutzer innerhalb von 30 Tagen lizenziert werden, damit das Postfach nicht deaktiviert wird.

  • Lizenzen. Eine Liste der Benutzerlizenzen.

  • LiveID. Die eindeutige Anmelde-ID des Benutzers.

  • Handy. Die Mobilfunknummer des Benutzers.

  • Objectid. Die eindeutige ID des Benutzers.

  • Büro. Die Büronummer des Benutzers.

  • OverallProvisioningStatus. Gibt an, ob Dienste für den Benutzer bereitgestellt wurden.

  • PasswordNeverExpires. Gibt an, ob alle 90 Tage eine Änderung des Benutzerkennworts erzwungen werden soll.

  • Phonenumber. Die Telefonnummer des Benutzers.

  • Postalcode. Die Postleitzahl des Benutzers.

  • PreferredDataLocation. Der bevorzugte Speicherort des Benutzers.

  • PreferredLanguage. Die bevorzugte Sprache des Benutzers.

  • Proxyaddresses. Die Proxyadressen, die diesem Benutzer zugeordnet sind.

  • Status. Das Bundesland des Benutzers.

  • StreetAddress. Die Straße des Benutzers.

  • StrongPasswordRequired. Gibt an, ob der Benutzer beim Ändern seines Kennworts ein sicheres Kennwort festlegen muss. Sichere Kennwörter werden empfohlen.

  • Titel. Die Anrede des Benutzers.

  • UsageLocation. Das Land oder die Region, in dem die Dienste vom Benutzer genutzt werden. Dabei muss es sich um einen Zweibuchstaben-Länder- oder Regionscode handelt.

  • Userprincipalname. Die Benutzer-ID des Benutzers.

  • Ein ValidationStatus. Gibt an, ob für den Benutzer Fehler aufgetreten sind.