Get-MsolUser

Modul:

MSOnline

Hämtar användare från Azure Active Directory.

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

Description

Cmdleten Get-MsolUser hämtar en enskild användare eller lista över användare. Ange parametern ObjectId eller UserPrincipalName för att hämta en specifik användare.

Exempel

Exempel 1: Hämta alla användare

PS C:\> Get-MsolUser

Det här kommandot hämtar alla användare i företaget. Den visar upp till standardvärdet 500 resultat.

Exempel 2: Hämta aktiverade användare

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

Det här kommandot hämtar upp till 2 000 aktiverade användare.

Exempel 3: Hämta en användare via UPN

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

Det här kommandot hämtar användaren med UPN davidchew@contoso.com.

Exempel 4: Hämta en användare efter objekt-ID

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

Det här kommandot hämtar en användare som har det angivna objekt-ID:t.

Exempel 5: Hämta användare via söksträng

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

Det här kommandot hämtar en lista över användare med David i visningsnamnet eller e-postadressen.

Exempel 6: Hämta önskad dataplats för en användare

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

Det här kommandot returnerar önskad dataplats för en användare.

Parametrar

-All

Anger att den här cmdleten returnerar alla resultat. Ange inte tillsammans med parametern MaxResults .

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

-City

Anger den stad som resultatet ska filtreras på.

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

-Country

Anger det land eller den region som resultatet ska filtreras på.

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

-Department

Anger vilken avdelning som resultat ska filtreras på.

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

-DomainName

Anger domänen som resultat ska filtreras på. Detta måste vara en verifierad domän för företaget. Alla användare med en e-postadress, primär eller sekundär, på den här domänen returneras.

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

-EnabledFilter

Anger filtret för aktiverade eller inaktiverade användare. Giltiga värden är Alla, EnabledOnly och DisabledOnly.

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

-HasErrorsOnly

Inidates att denna cmdlet endast returnerar användare som har valideringsfel.

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

-LicenseReconciliationNeededOnly

Anger att det här cmdlet-filtret endast för användare som kräver licensavstämning.

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

-MaxResults

Anger det maximala antalet resultat som den här cmdleten returnerar. Standardvärdet är 500.

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

-ObjectId

Anger det unika objekt-ID för användaren som ska hämtas.

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

-ReturnDeletedUsers

Anger att den här cmdleten endast returnerar användare i papperskorgen.

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

-SearchString

Anger en sträng som matchar e-postadressen eller visningsnamnet från och med den här strängen.

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

-State

Anger filtret för användarens tillstånd.

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

-Synchronized

Anger att den här cmdleten endast returnerar användare som synkroniseras via Azure Active Directory Sync.

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

-TenantId

Anger det unika ID för klientorganisationen som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.

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

-Title

Speicifies filtret för användarens titel.

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

-UnlicensedUsersOnly

Anger att den här cmdleten endast returnerar användare som inte har tilldelats en licens.

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

-UsageLocation

Anger filtret för det land eller den region där tjänsterna används av användaren. Ange en lands- eller regionkod med två bokstäver.

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

-UserPrincipalName

Speicifies användar-ID för användaren som ska hämtas.

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

Utdata

Microsoft.Online.Administration.User

Den här cmdleten returnerar användarobjekt som innehåller följande information:

• AlternateEmailAddresses. Alternativ e-postadress till användaren (extern till Azure Active Directory).

• BlockCredential. Om användaren kan logga in eller inte.

• Staden. Användarens stad.

• Land. Användarens land eller region.

• Institutionen. Användarens avdelning.

• Displayname. Användarens visningsnamn.

• Fel. En matris med fel. Det här är valideringsfel som kan leda till förlust av tjänster.

• Fax. Användarens faxnummer.

• Förnamn. Användarens förnamn.

• OföränderligtID. Returneras endast för federerade användare. Det här är det ID som krävs för att federeras med Azure Active Directory.

• isBlackBerryUser. Returnerar om användaren har en BlackBerry-enhet eller inte.

• isLicensed. Om användaren har tilldelats några licenser eller inte.

• LastDirSyncTime. Datum och tid för den senaste katalogsynkroniseringen (returneras endast från användare som synkroniserats med Azure Active Directory via Active Directory-synkronisering).

• LastPasswordChangeTimestamp. Den senaste gången en lösenordsändring för användaren registrerades i Azure Active Directory.

• Efternamn. Användarens efternamn.

• LicenseReconciliationNeededed. Oavsett om användaren för närvarande har en postlåda utan licens eller inte. I det här fallet ska användaren licensieras med 30 dagar för att undvika att förlora sin postlåda.

• Licenser. En lista över användarens licenser.

• LiveID. Användarens unika inloggnings-ID.

• MobilePhone. Användarens mobiltelefonnummer.

• Objectid. Användarens unika ID.

• Office. Användarens kontorsnummer.

• OverallProvisioningStatus. Om användaren har etablerats för sina tjänster eller inte.

• PasswordNeverExpires. Om användarens lösenord ska tvingas att ändras var 90:e dag.

• PhoneNumber. Användarens telefonnummer.

• Postnummer. Användarens postnummer.

• PreferredDataLocation. Användarens önskade dataplats.

• PreferredLanguage. Användarens föredragna språk.

• Proxyaddresses. Proxyadresserna som är associerade med den här användaren.

• Statligt. Användarens tillstånd.

• StreetAddress. Användarens gatuadress.

• StrongPasswordRequired. Om användaren måste ange ett starkt lösenord när de ändrar sitt lösenord. Starka lösenord rekommenderas.

• Titel. Användarens titel.

• UsageLocation. Det land eller den region där tjänsterna används av användaren. Detta måste vara en lands- eller regionkod med två bokstäver.

• UserPrincipalName. Användarens användar-ID.

• ValidationStatus. Om användaren har några fel eller inte.

Relaterade länkar

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