Delen via

Get-MsolUser

  • Referentie
Module:
MSOnline

Hiermee haalt u gebruikers op uit Azure Active Directory.

Syntaxis

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>]

Description

De cmdlet Get-MsolUser haalt een afzonderlijke gebruiker of lijst met gebruikers op. Geef de parameter ObjectId of UserPrincipalName op om een specifieke gebruiker op te halen.

Voorbeelden

Voorbeeld 1: Alle gebruikers ophalen

PS C:\> Get-MsolUser

Met deze opdracht worden alle gebruikers in het bedrijf opgehaald. Het wordt weergegeven tot de standaardwaarde van 500 resultaten.

Voorbeeld 2: Ingeschakelde gebruikers ophalen

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

Met deze opdracht worden maximaal 2000 gebruikers ingeschakeld.

Voorbeeld 3: Een gebruiker ophalen op UPN

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

Met deze opdracht wordt de gebruiker opgehaald met de UPN davidchew@contoso.com.

Voorbeeld 4: Een gebruiker ophalen op object-id

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

Met deze opdracht wordt een gebruiker opgehaald die de opgegeven object-id heeft.

Voorbeeld 5: Gebruikers ophalen op zoektekenreeks

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

Met deze opdracht wordt een lijst met gebruikers opgehaald met David in de weergavenaam of het e-mailadres.

Voorbeeld 6: Voorkeursgegevenslocatie van een gebruiker ophalen

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

Met deze opdracht wordt de voorkeursgegevenslocatie van een gebruiker geretourneerd.

Parameters

-All

Geeft aan dat deze cmdlet alle resultaten retourneert. Geef niet op samen met de parameter MaxResults .

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-City

Hiermee geeft u de plaats op waarop de resultaten moeten worden gefilterd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Country

Hiermee geeft u het land of de regio op waarop de resultaten moeten worden gefilterd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Department

Hiermee geeft u de afdeling waarop de resultaten moeten worden gefilterd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DomainName

Hiermee geeft u het domein waarop de resultaten moeten worden gefilterd. Dit moet een geverifieerd domein voor het bedrijf zijn. Alle gebruikers met een e-mailadres, primair of secundair, in dit domein worden geretourneerd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EnabledFilter

Hiermee geeft u het filter voor ingeschakelde of uitgeschakelde gebruikers. Geldige waarden zijn All, EnabledOnly en DisabledOnly.

Type:UserEnabledFilter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HasErrorsOnly

Hiermee wordt aangegeven dat deze cmdlet alleen gebruikers retourneert die validatiefouten hebben.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LicenseReconciliationNeededOnly

Geeft aan dat dit cmdlet-filter alleen is bedoeld voor gebruikers die licentieafstemming nodig hebben.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxResults

Hiermee geeft u het maximum aantal resultaten dat deze cmdlet retourneert. De standaardwaarde is 500.

Type:Int32
Position:Named
Default value:500
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ObjectId

Hiermee geeft u de unieke object-id van de gebruiker op te halen.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ReturnDeletedUsers

Geeft aan dat deze cmdlet alleen gebruikers in de prullenbak retourneert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SearchString

Hiermee geeft u een tekenreeks op die overeenkomt met het e-mailadres of de weergavenaam die begint met deze tekenreeks.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-State

Hiermee geeft u het filter voor de status van de gebruiker.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Synchronized

Geeft aan dat deze cmdlet alleen gebruikers retourneert die zijn gesynchroniseerd via Azure Active Directory-synchronisatie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TenantId

Hiermee geeft u de unieke id van de tenant op waarop de bewerking moet worden uitgevoerd. De standaardwaarde is de tenant van de huidige gebruiker. Deze parameter is alleen van toepassing op partnergebruikers.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Title

Hiermee wordt het filter voor de titel van de gebruiker opgegeven.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UnlicensedUsersOnly

Geeft aan dat deze cmdlet alleen gebruikers retourneert aan wie geen licentie is toegewezen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UsageLocation

Hiermee geeft u het filter op voor het land of de regio waar de services worden gebruikt door de gebruiker. Geef een land- of regiocode van twee letters op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserPrincipalName

Hiermee wordt de gebruikers-id van de gebruiker opgegeven die moet worden opgehaald.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.Online.Administration.User

Deze cmdlet retourneert gebruikersobjecten, waaronder de volgende informatie:

  • AlternateEmailAddresses. Alternatief e-mailadres van de gebruiker (extern naar Azure Active Directory).

  • BlockCredential. Of de gebruiker zich kan aanmelden.

  • Stad. De plaats van de gebruiker.

  • Land. Het land of de regio van de gebruiker.

  • Departement. De afdeling van de gebruiker.

  • Displayname. De weergavenaam van de gebruiker.

  • Fouten. Een matrix met fouten. Dit zijn validatiefouten die kunnen leiden tot het verlies van services.

  • Fax. Het faxnummer van de gebruiker.

  • Voornaam. De voornaam van de gebruiker.

  • Onveranderbare ID. Alleen geretourneerd voor federatieve gebruikers. Dit is de id die moet worden gefedereerd met Azure Active Directory.

  • isBlackBerryUser. Retourneert of de gebruiker al dan niet een BlackBerry-apparaat heeft.

  • isLicensed. Of aan de gebruiker licenties zijn toegewezen.

  • LastDirSyncTime. De datum en tijd van de laatste adreslijstsynchronisatie (alleen geretourneerd door gebruikers die zijn gesynchroniseerd met Azure Active Directory via Active Directory-synchronisatie).

  • LastPasswordChangeTimestamp. Het meest recente tijdstip waarop een wachtwoordwijziging voor de gebruiker is geregistreerd in Azure Active Directory.

  • Achternaam. De achternaam van de gebruiker.

  • LicenseReconciliationNeeded. Of de gebruiker momenteel een postvak zonder licentie heeft of niet. In dit geval moet de gebruiker 30 dagen een licentie krijgen om te voorkomen dat het postvak verloren gaat.

  • Licenties. Een lijst met de licenties van de gebruiker.

  • LiveID. De unieke aanmeldings-id van de gebruiker.

  • Mobiele telefoon. Het mobiele telefoonnummer van de gebruiker.

  • ObjectId. De unieke id van de gebruiker.

  • Office. Het kantoornummer van de gebruiker.

  • OverallProvisioningStatus. Of de gebruiker al dan niet is ingericht voor zijn of haar services.

  • PasswordNeverExpires. Of het wachtwoord van de gebruiker elke 90 dagen moet worden gewijzigd.

  • Telefoonnummer. Het telefoonnummer van de gebruiker.

  • Postcode. De postcode van de gebruiker.

  • PreferredDataLocation. De voorkeursgegevenslocatie van de gebruiker.

  • PreferredLanguage. De voorkeurstaal van de gebruiker.

  • Proxyadressen. De proxyadressen die aan deze gebruiker zijn gekoppeld.

  • Staat. De status van de gebruiker.

  • StreetAddress. Het adres van de gebruiker.

  • StrongPasswordRequired. Of de gebruiker een sterk wachtwoord moet instellen wanneer hij of zij het wachtwoord wijzigt. Sterke wachtwoorden worden aanbevolen.

  • Titel. De titel van de gebruiker.

  • UsageLocation. Het land of de regio waar de services worden gebruikt door de gebruiker. Dit moet een land- of regiocode van twee letters zijn.

  • UserPrincipalName. De gebruikers-id van de gebruiker.

  • ValidationStatus. Of de gebruiker fouten heeft of niet.