共用方式為


Get-AzADUser

列出用戶的實體,或依索引鍵從使用者取得實體

語法

Get-AzADUser
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -DisplayName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

Description

列出用戶的實體,或依索引鍵從使用者取得實體

範例

範例 1:取得登入使用者

Get-AzADUser -SignedIn

取得登入使用者

範例 2:列出使用者

Get-AzADUser -First 10 -Select 'City' -AppendSelected

列出前 10 位使用者,並在默認屬性之後附加屬性 'City':'DisplayName'、'Id'、'DeletedDateTime'、'UserPrincipalName'、'UsageLocation'、'GivenName'、'SurName'、'AccountEnabled'、'MailNickName'、'Mail'

範例 3:依顯示名稱取得使用者

Get-AzADUser -DisplayName $name

依顯示名稱取得使用者

範例 4:取得具有篩選的使用者

Get-AzADUser -Filter "startsWith(DisplayName,'some-name')"

使用篩選取得使用者

範例 5:將 OdataCount 指派給變數

Get-AzADUser -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

將 OdataCount 指派給變數

參數

-AppendSelected

在開啟此參數時,附加以預設屬性選取的屬性,僅適用於參數 '-Select'。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConsistencyLevel

表示要求的一致性層級。 檔案 URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Count

包含項目計數

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CountVariable

指定集合中項目總數的計數。 根據預設,此變數會在全域範圍中設定。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:PSObject
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisplayName

用戶顯示名稱

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Expand

展開相關實體

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Filter

依屬性值篩選專案,如需篩選查詢的詳細資訊,請參閱: https://learn.microsoft.com/en-us/graph/filter-query-parameter

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-First

只取得第一個 『n』 物件。

類型:UInt64
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Mail

使用者郵件位址

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ObjectId

機碼:用戶的標識碼

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Orderby

依屬性值排序專案

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

依搜尋片語搜尋專案

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Select

選取要傳回的屬性

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SignedIn

使用者郵件位址

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Skip

忽略第一個 'n' 對象,然後取得其餘的物件。

類型:UInt64
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-StartsWith

用戶顯示名稱開頭為

類型:String
別名:SearchString
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-UserPrincipalName

用戶主體名稱

類型:String
別名:UPN
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸出

IMicrosoftGraphUser

備註

別名