Get-MsolUser
Získá uživatele z 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
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 |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Určuje město, podle které chcete filtrovat výsledky.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Určuje zemi nebo oblast, podle které se mají výsledky filtrovat.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Určuje oddělení pro filtrování výsledků.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnabledFilter
Určuje filtr pro povolené nebo zakázané uživatele. Platné hodnoty jsou Vše, EnabledOnly a DisabledOnly.
Typ: | UserEnabledFilter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HasErrorsOnly
Iniduje, že tato rutina vrací jenom uživatele, u kterých došlo k chybám ověření.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseReconciliationNeededOnly
Označuje, že tato rutina filtruje pouze uživatele, kteří vyžadují odsouhlasení licencí.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxResults
Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 500.
Typ: | Int32 |
Position: | Named |
výchozí hodnota: | 500 |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Určuje jedinečné ID objektu uživatele, který se má získat.
Typ: | Guid |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReturnDeletedUsers
Označuje, že tato rutina vrací pouze uživatele v koši.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Určuje filtr stavu uživatele.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Title
Vyhledá filtr pro titul uživatele.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnlicensedUsersOnly
Označuje, že tato rutina vrací jenom uživatele, kteří nemají přiřazenou licenci.
Typ: | SwitchParameter |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
výchozí hodnota: | None |
Vyžadováno: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Speicifies id uživatele, který se má načíst.
Typ: | String |
Position: | Named |
výchozí hodnota: | None |
Vyžadováno: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro