Sdílet prostřednictvím

Get-MsolUser

  • Reference
Modul:
MSOnline

Získá uživatele z Azure Active Directory.

Syntaxe

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

Rutina Get-MsolUser získá jednotlivého uživatele nebo seznam uživatelů. Zadáním parametru ObjectId nebo UserPrincipalName získáte konkrétního uživatele.

Příklady

Příklad 1: Získání všech uživatelů

PS C:\> Get-MsolUser

Tento příkaz načte všechny uživatele ve společnosti. Zobrazí se až výchozí hodnota 500 výsledků.

Příklad 2: Získání povolených uživatelů

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

Tento příkaz získá až 2000 povolených uživatelů.

Příklad 3: Získání uživatele podle hlavního názvu uživatele (UPN)

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

Tento příkaz načte uživatele s hlavního názvu uživatele (UPN) davidchew@contoso.com.

Příklad 4: Získání uživatele podle ID objektu

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

Tento příkaz načte uživatele, který má zadané ID objektu.

Příklad 5: Získání uživatelů pomocí vyhledávacího řetězce

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

Tento příkaz načte seznam uživatelů s Davidem v zobrazované jméno nebo e-mailovou adresu.

Příklad 6: Získání upřednostňovaného umístění dat uživatele

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

Tento příkaz vrátí upřednostňované umístění dat uživatele.

Parametry

-All

Označuje, že tato rutina vrací všechny výsledky. Nezadávejte společně s parametrem MaxResults .

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-City

Určuje město, podle které chcete filtrovat výsledky.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Country

Určuje zemi nebo oblast, podle které se mají výsledky filtrovat.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Department

Určuje oddělení pro filtrování výsledků.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DomainName

Určuje doménu pro filtrování výsledků. Musí se jednat o ověřenou doménu společnosti. Vrátí se všichni uživatelé s primární nebo sekundární e-mailovou adresou v této doméně.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnabledFilter

Určuje filtr pro povolené nebo zakázané uživatele. Platné hodnoty jsou Vše, EnabledOnly a DisabledOnly.

Typ:UserEnabledFilter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HasErrorsOnly

Iniduje, že tato rutina vrací jenom uživatele, u kterých došlo k chybám ověření.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LicenseReconciliationNeededOnly

Označuje, že tato rutina filtruje pouze uživatele, kteří vyžadují odsouhlasení licencí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxResults

Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 500.

Typ:Int32
Position:Named
Default value:500
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ObjectId

Určuje jedinečné ID objektu uživatele, který se má získat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ReturnDeletedUsers

Označuje, že tato rutina vrací pouze uživatele v koši.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SearchString

Určuje řetězec, který se má shodovat s e-mailovou adresou nebo zobrazovaným jménem začínajícím tímto řetězcem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-State

Určuje filtr stavu uživatele.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Synchronized

Označuje, že tato rutina vrací jenom uživatele, kteří jsou synchronizovaní prostřednictvím služby Azure Active Directory Sync.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TenantId

Určuje jedinečné ID tenanta, na kterém se má operace provést. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr platí jenom pro uživatele partnerů.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Title

Vyhledá filtr pro titul uživatele.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UnlicensedUsersOnly

Označuje, že tato rutina vrací jenom uživatele, kteří nemají přiřazenou licenci.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UsageLocation

Určuje filtr pro zemi nebo oblast, ve které jsou služby uživatelem využívány. Zadejte dvoumísmenný kód země nebo oblasti.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserPrincipalName

Speicifies id uživatele, který se má načíst.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Microsoft.Online.Administration.User

Tato rutina vrátí objekty uživatele, které obsahují následující informace:

  • AlternateEmailAddresses. Alternativní e-mailová adresa uživatele (externí do Azure Active Directory)

  • BlockCredential. Určuje, jestli se uživatel může přihlásit.

  • Město. Město uživatele.

  • Země. Země nebo oblast uživatele.

  • Oddělení. Oddělení uživatele.

  • Displayname. Zobrazované jméno uživatele.

  • Chyby. Pole chyb. Jedná se o chyby ověřování, které můžou vést ke ztrátě služeb.

  • Faxové. Faxové číslo uživatele.

  • Jméno. Jméno uživatele

  • ImmutableID. Vráceno pouze pro federované uživatele. Toto je ID, které se vyžaduje k federované službě Azure Active Directory.

  • isBlackBerryUser. Vrátí informace o tom, zda má uživatel zařízení BlackBerry.

  • isLicensed. Určuje, jestli má uživatel přiřazené nějaké licence.

  • LastDirSyncTime. Datum a čas poslední synchronizace adresářů (vráceno pouze od uživatelů synchronizovaných s Azure Active Directory prostřednictvím synchronizace Active Directory).

  • LastPasswordChangeTimestamp. Poslední čas, kdy se v Azure Active Directory zaregistrovala změna hesla uživatele.

  • Lastname. Příjmení uživatele

  • LicenseReconciliationNeeded. Určuje, jestli má uživatel v současné době poštovní schránku bez licence. V takovém případě by měl mít uživatel licenci na 30 dnů, aby nepřišla o poštovní schránku.

  • Licence. Seznam uživatelských licencí.

  • LiveID. Jedinečné přihlašovací ID uživatele.

  • MobilePhone. Číslo mobilního telefonu uživatele.

  • Objectid. Jedinečné ID uživatele.

  • Office. Číslo kanceláře uživatele.

  • OverallProvisioningStatus. Informace o tom, jestli byl uživatel zřízený pro své služby.

  • PasswordNeverExpires. Jestli se má každých 90 dní vynucovat změna hesla uživatele.

  • Phonenumber. Telefonní číslo uživatele.

  • Postalcode. PSČ uživatele.

  • PreferredDataLocation. Upřednostňované umístění dat uživatele.

  • PreferredLanguage. Upřednostňovaný jazyk uživatele

  • Proxyaddresses. Adresy proxy serveru přidružené k tomuto uživateli.

  • Státu. Stav uživatele.

  • Streetaddress. Adresa uživatele.

  • StrongPasswordRequired. Jestli musí uživatel při změně hesla nastavit silné heslo. Doporučujeme silná hesla.

  • Název. Titul uživatele.

  • UsageLocation. Země nebo oblast, ve které jsou služby využívány uživatelem. Musí se jednat o dvoumísmenný kód země nebo oblasti.

  • Userprincipalname. ID uživatele.

  • ValidationStatus. Určuje, jestli má uživatel nějaké chyby.