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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Určuje město, podle které chcete filtrovat výsledky.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Určuje zemi nebo oblast, podle které chcete filtrovat výsledky.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Určuje oddělení pro filtrování výsledků.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Určuje doménu pro filtrování výsledků. Toto musí být ověřená doména společnosti. Vrátí se všichni uživatelé s primární nebo sekundární e-mailovou adresou v této doméně.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | UserEnabledFilter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HasErrorsOnly
Iniduje, že tato rutina vrací pouze uživatele, kteří mají chyby ověřování.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseReconciliationNeededOnly
Označuje, že tato rutina filtruje pouze uživatele, kteří vyžadují odsouhlasení licencí.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | Int32 |
Position: | Named |
Default value: | 500 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Určuje jedinečné ID objektu uživatele, který se má získat.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReturnDeletedUsers
Označuje, že tato rutina vrací pouze uživatele v koši.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | 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 názvem začínajícím tímto řetězcem.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Určuje filtr pro stav uživatele.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | 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 partnerské uživatele.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Title
Zobrazí filtr pro název uživatele.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnlicensedUsersOnly
Označuje, že tato rutina vrací pouze uživatele, kteří nemají přiřazenou licenci.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
Určuje filtr pro zemi nebo oblast, ve které jsou služby využívány uživatelem. Zadejte dvoumísmenný kód země nebo oblasti.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Zobrazí ID uživatele, který se má načíst.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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