Bagikan melalui

Get-AzureADUser

  • Referensi
Modul:
AzureAD

Mendapatkan pengguna.

Sintaks

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

Deskripsi

Cmdlet Get-AzureADUser mendapatkan pengguna dari ID Microsoft Entra.

Contoh

Contoh 1: Dapatkan sepuluh pengguna teratas

PS C:\>Get-AzureADUser -Top 10

Perintah ini mendapatkan 10 pengguna.

Contoh 2: Mendapatkan pengguna berdasarkan ID

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

Perintah ini mendapatkan pengguna yang ditentukan.

Contoh 3: Mencari di antara pengguna yang diambil

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

Cmdlet ini mendapatkan semua pengguna yang cocok dengan nilai SearchString terhadap karakter pertama di DisplayName atau UserPrincipalName.

Contoh 4: Mendapatkan pengguna menurut userPrincipalName

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

Perintah ini mendapatkan pengguna yang ditentukan.

Contoh 5: Mendapatkan pengguna dengan JobTitle

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

Perintah ini mendapatkan semua pengguna yang jabatannya dimulai dengan penjualan, misalnya Sales Manager, dan Asisten Penjualan.

Parameter

-All

Jika true, kembalikan semua pengguna. Jika false, kembalikan jumlah objek yang ditentukan oleh parameter Atas

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

-Filter

Menentukan pernyataan filter OData v3.0. Parameter ini mengontrol objek mana yang dikembalikan. Detail tentang kueri dengan OData dapat ditemukan di sini. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Tidak semua fungsi dan operator OData v3.0 didukung saat ini.

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

-ObjectId

Menentukan ID (sebagai UPN atau ObjectId) pengguna dalam ID Microsoft Entra.

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

-SearchString

Menentukan string pencarian.

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

-Top

Menentukan jumlah maksimum rekaman yang akan dikembalikan.

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

Catatan

Lihat panduan migrasi untuk Get-AzureADUser ke Microsoft Graph PowerShell.