Dela via

Get-MsolUser

  • Referens
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 .

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-City

Anger den stad som resultatet ska filtreras på.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Country

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Department

Anger vilken avdelning som resultat ska filtreras på.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DomainName

Anger vilken domän 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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnabledFilter

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

Typ:UserEnabledFilter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HasErrorsOnly

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LicenseReconciliationNeededOnly

Anger att detta cmdlet-filter endast ska användas för användare som behöver licensavstämning.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxResults

Anger det maximala antalet resultat som denna cmdlet returnerar. Standardvärdet är 500.

Typ:Int32
Position:Named
Standardvärde:500
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ObjectId

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

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ReturnDeletedUsers

Anger att denna cmdlet endast returnerar användare i papperskorgen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SearchString

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-State

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Synchronized

Anger att denna cmdlet endast returnerar användare som synkroniseras via Azure Active Directory Sync.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TenantId

Anger det unika ID:t för den klientorganisation 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.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Title

Speicifies filtret för rubriken på användaren.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UnlicensedUsersOnly

Anger att denna cmdlet endast returnerar användare som inte har tilldelats en licens.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserPrincipalName

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.