Get-EntraAdministrativeUnit
會有行政單位。
語法
GetQuery (預設值)
Get-EntraAdministrativeUnit
[-Top <Int32>]
[-All]
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraAdministrativeUnit
-AdministrativeUnitId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Description
該Get-EntraAdministrativeUnit指令長會獲得 Microsoft Entra ID 管理單元。 指定 AdministrativeUnitId 參數以獲得特定的行政單位。
範例
範例一：取得所有行政單位
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Updated Description Updated DisplayName
cccccccc-2222-3333-4444-dddddddddddd testdemo test1
bbbbbbbb-1111-2222-3333-cccccccccccc TestAU
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb test_130624_09
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb demotest test111
這個指揮部負責所有行政單位。
範例 2：使用「-All」參數取得所有行政單位
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -All
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
dddddddd-3333-4444-5555-eeeeeeeeeeee Updated Description Updated DisplayName
cccccccc-2222-3333-4444-dddddddddddd testdemo test1
bbbbbbbb-1111-2222-3333-cccccccccccc TestAU
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb test_130624_09
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb demotest test111
這個指揮部負責所有行政單位。
範例三：設立特定的行政單位
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -AdministrativeUnitId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Updated Description Updated DisplayName
此範例會回傳指定行政單位的詳細資訊。
-
-AdministrativeUnitId參數指定行政單位的識別碼。
範例 4：依顯示名稱篩選管理單位
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -Filter "DisplayName eq 'DAU-Test'"
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Dynamic AU testing in CORP tenant DAU-Test
此範例包含顯示名稱與指定名稱的行政單位列表。
範例5：取得頂尖行政單位
Connect-Entra -Scopes 'AdministrativeUnit.Read.All'
Get-EntraAdministrativeUnit -Top 1
DeletedDateTime Id Description DisplayName Visibility
--------------- -- ----------- ----------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Dynamic AU testing in CORP tenant DAU-Test
此範例回傳指定的頂層行政單位。 您可以使用 -Limit 作為 -Top的別名。
參數
-AdministrativeUnitId
指定 Microsoft Entra ID 中管理單元的 ID。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ObjectId (物件識別碼) |
參數集
GetById
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-All
列出所有頁面。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
指定 OData v4.0 濾波語句。 此參數會過濾回傳的物件。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetQuery
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Property
指定要回傳的屬性。
參數屬性
| 類型: | System.String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 選取 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Top
指定回傳的最大紀錄數量。
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 極限 |
參數集
GetQuery
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。