Get-AzureADUser

  • Reference
Modul:
AzureAD

Získá uživatele.

Syntax

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADUser
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

Rutina Get-AzureADUser získá uživatele z ID Microsoft Entra.

Příklady

Příklad 1: Získání prvních deseti uživatelů

PS C:\>Get-AzureADUser -Top 10

Tento příkaz získá 10 uživatelů.

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

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

Tento příkaz získá zadaného uživatele.

Příklad 3: Hledání mezi načteným uživatelem

PS C:\> Get-AzureADUser -SearchString "New"

ObjectId                             DisplayName UserPrincipalName                   UserType
--------                             ----------- -----------------                   --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

Tato rutina načte všechny uživatele, kteří odpovídají hodnotě SearchString s prvními znaky v DisplayName nebo UserPrincipalName.

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

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

Tento příkaz získá zadaného uživatele.

Příklad 5: Získání uživatele podle JobTitle

PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"

Tento příkaz získá všechny uživatele, jejichž pracovní pozice začíná prodejem, například Manažer prodeje a Asistent prodeje.

Parametry

-All

Pokud je hodnota true, vraťte všechny uživatele. Pokud je false, vrátí počet objektů určený parametrem Top.

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

-Filter

Určuje příkaz filtru OData v3.0. Tento parametr určuje, které objekty se vrátí. Podrobnosti o dotazování pomocí OData najdete tady. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. V tuto chvíli nejsou podporované všechny funkce a operátory OData verze 3.0.

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

-ObjectId

Určuje ID uživatele (jako UPN nebo ObjectId) v Microsoft Entra ID.

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

-SearchString

Určuje hledaný řetězec.

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

-Top

Určuje maximální počet záznamů, které se mají vrátit.

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

Poznámky

Projděte si průvodce migrací get-AzureADUser do Prostředí Microsoft Graph PowerShell.