Get-AzADUser
語法
List (預設值)
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>]
MailParameterSet
Get-AzADUser
-Mail <String>
[-Expand <String[]>]
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
DisplayNameParameterSet
Get-AzADUser
-DisplayName <String>
[-Expand <String[]>]
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
StartsWithParameterSet
Get-AzADUser
-StartsWith <String>
[-Expand <String[]>]
[-Select <String[]>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
ObjectIdParameterSet
Get-AzADUser
-ObjectId <String>
[-Expand <String[]>]
[-Select <String[]>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
UPNParameterSet
Get-AzADUser
-UserPrincipalName <String>
[-Expand <String[]>]
[-Select <String[]>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
SignedInUser
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'。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConsistencyLevel
指出要求的一致性層級。
文件網址： https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Count
包括項目計數
參數屬性
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CountVariable
指定集合中項目總數的計數。
預設情況下，此變數將在全域範圍內設定。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
| 類型: | PSObject
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | AzContext, AzureRmContext, AzureCredential |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayName
使用者顯示名稱
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
DisplayNameParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Expand
展開相關實體
參數屬性
| 類型: | String[]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
按屬性值過濾項目，有關過濾器查詢的更多詳細信息，請參閱： https://learn.microsoft.com/en-us/graph/filter-query-parameter
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-First
只取得第一個 『n』 物件。
參數屬性
| 類型: | UInt64
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MailParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DisplayNameParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
StartsWithParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Mail
使用者郵件位址
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
MailParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ObjectId
key：使用者的ID
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ObjectIdParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Orderby
依屬性值排序專案
參數屬性
| 類型: | String[]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Search
依搜尋片語搜尋項目
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Select
選取要傳回的屬性
參數屬性
| 類型: | String[]
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SignedIn
使用者郵件位址
參數屬性
參數集
SignedInUser
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Skip
忽略第一個 'n' 對象，然後取得其餘的物件。
參數屬性
| 類型: | UInt64
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
List
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
MailParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DisplayNameParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
StartsWithParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StartsWith
使用者顯示名稱開頭為
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 搜尋字串 |
參數集
StartsWithParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UserPrincipalName
使用者主體名稱
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | UPN |
參數集
UPNParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
