Aracılığıyla paylaş

Get-AzureADUser

  • Başvuru
Modül:
AzureAD

Bir kullanıcıyı alır.

Sözdizimi

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

Description

Get-AzureADUser cmdlet'i, Microsoft Entra Id'den bir kullanıcı alır.

Örnekler

Örnek 1: İlk on kullanıcıyı alma

PS C:\>Get-AzureADUser -Top 10

Bu komut 10 kullanıcı alır.

Örnek 2: Kimliğine göre kullanıcı alma

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

Bu komut belirtilen kullanıcıyı alır.

Örnek 3: Alınan kullanıcılar arasında arama

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

Bu cmdlet, DisplayName veya UserPrincipalName içindeki ilk karakterlerle SearchString değeriyle eşleşen tüm kullanıcıları alır.

Örnek 4: userPrincipalName ile kullanıcı alma

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

Bu komut belirtilen kullanıcıyı alır.

Örnek 5: JobTitle ile kullanıcı alma

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

Bu komut, iş unvanı satışla başlayan tüm kullanıcıları (örneğin Satış Yöneticisi ve Satış Yardımcısı) alır.

Parametreler

-All

True ise, tüm kullanıcıları döndür. False ise, Top parametresi tarafından belirtilen nesne sayısını döndür

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Filter

OData v3.0 filtre deyimini belirtir. Bu parametre hangi nesnelerin döndürülür denetler. OData ile sorgulamayla ilgili ayrıntıları burada bulabilirsiniz. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Şu anda tüm OData v3.0 işlevleri ve işleçleri desteklenmemaktadır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ObjectId

Microsoft Entra Id'de bir kullanıcının kimliğini (UPN veya ObjectId olarak) belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SearchString

Bir arama dizesi belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Top

Döndürülecek en fazla kayıt sayısını belirtir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Notlar

Get-AzureADUser için Microsoft Graph PowerShell'e geçiş kılavuzuna bakın.