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.