Get-MsolUser

Modul:

MSOnline

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 der Benutzer 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. Sie zeigt bis zum Standardwert von 500 Ergebnissen an.

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 Datenspeicherort eines Benutzers zurück.

Parameter

-All

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-City

Gibt die Stadt an, um Ergebnisse zu filtern.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Country

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Department

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 E-Mail-Adresse, primärer oder sekundärer Adresse in dieser Domäne werden zurückgegeben.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnabledFilter

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

Type:	UserEnabledFilter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-HasErrorsOnly

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseReconciliationNeededOnly

Gibt an, dass dieses Cmdlet nur für Benutzer gefiltert wird, die eine Lizenzabstimmung erfordern.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxResults

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

Type:	Int32
Position:	Named
Default value:	500
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

Gibt die eindeutige Objekt-ID des abzurufenden Benutzers an.

Type:	Guid
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnDeletedUsers

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SearchString

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-State

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Synchronized

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Guid
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Title

Speicifiziert den Filter für den Titel des Benutzers.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UnlicensedUsersOnly

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UsageLocation

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPrincipalName

Speicifiziert die Benutzer-ID des abzurufenden Benutzers.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

Ausgaben

Microsoft.Online.Administration.User

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

• AlternativeEmailAddresses. Alternative E-Mail-Adresse des Benutzers (extern zu Azure Active Directory).

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

• City. Die Stadt des Benutzers.

• Land. Das Land 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.

• Unveränderliche ID. Wird nur für Partnerbenutzer zurückgegeben. Dies ist die ID, die zum 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 neueste 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.

• GesamtprovisioningStatus. 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, in dem der Benutzer Dienste nutzt. Dies muss ein aus zwei Buchstaben bestehender Ländercode sein.

• Userprincipalname. Die Benutzer-ID des Benutzers.

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

Ähnliche Themen

• New-MsolUser
• Remove-MsolUser
• Restore-MsolUser
• Set-MsolUser