Get-EntraAdministrativeUnitMember
管理単位のメンバーを取得します。
構文
Default (既定)
Get-EntraAdministrativeUnitMember
-AdministrativeUnitId <String>
[-All]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
説明
Get-EntraAdministrativeUnitMember コマンドレットは、Microsoft Entra ID管理単位のメンバーを取得します。 管理単位メンバー AdministrativeUnitId 取得するパラメーターを指定します。
職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーがメンバー ユーザーであるか、サポートされているMicrosoft Entra ロール、または必要なアクセス許可を持つカスタム ロールが割り当てられている必要があります。 この操作では、次の最小特権ロールがサポートされています。
- ディレクトリ 閲覧者: 管理単位の基本プロパティの読み取り
- グローバル 閲覧者: メンバーを含む、管理単位のすべてのプロパティを読み取ります
- 特権ロール管理者: 管理単位 (メンバーを含む) を作成および管理する
例
例 1: AdministrativeUnitId で管理単位メンバーを取得する
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id |
Select-Object Id, DisplayName, '@odata.type', createdDateTime
id DisplayName @odata.type CreatedDateTime
-- ----------- ----------- ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber #microsoft.graph.user 10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller #microsoft.graph.user 10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group 10/7/2024 12:43:47 AM
ffffffff-5555-6666-7777-aaaaaaaaaaaa Contoso Global #microsoft.graph.group 10/27/2024 6:48:09 AM
次の使用例は、指定した管理単位 AdministrativeUnitId から管理単位メンバーの一覧を返します。
-
-AdministrativeUnitIdパラメーターは、管理単位の ID を指定します。
例 2: AdministrativeUnitId ですべての管理単位メンバーを取得する
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -All |
Select-Object Id, DisplayName, '@odata.type', createdDateTime
id DisplayName @odata.type CreatedDateTime
-- ----------- ----------- ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber #microsoft.graph.user 10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller #microsoft.graph.user 10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group 10/7/2024 12:43:47 AM
ffffffff-5555-6666-7777-aaaaaaaaaaaa Contoso Global #microsoft.graph.group 10/27/2024 6:48:09 AM
次の使用例は、指定した管理単位 AdministrativeUnitId からすべての管理単位メンバーの一覧を返します。
-
-AdministrativeUnitIdパラメーターは、管理単位の ID を指定します。
例 3: AdministrativeUnitId によって上位 3 つの管理単位メンバーを取得する
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
Get-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -Top 3 |
Select-Object Id, DisplayName, '@odata.type', createdDateTime
id DisplayName @odata.type CreatedDateTime
-- ----------- ----------- ---------------
bbbbbbbb-1111-2222-3333-cccccccccccc Alex Wilber #microsoft.graph.user 10/7/2024 12:31:51 AM
cccccccc-2222-3333-4444-dddddddddddd Adele Miller #microsoft.graph.user 10/7/2024 12:32:17 AM
dddddddd-3333-4444-5555-eeeeeeeeeeee Sales and Marketing #microsoft.graph.group 10/7/2024 12:43:47 AM
この例では、指定された管理単位 ID から上位 3 つの管理単位メンバーを返します。
-Limitのエイリアスとして-Topを使用できます。
-
-AdministrativeUnitIdパラメーターは、管理単位の ID を指定します。
パラメーター
-AdministrativeUnitId
Microsoft Entra IDの管理単位の ID を指定します。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | オブジェクト識別子 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-All
すべてのページを一覧表示します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Property
返されるプロパティを指定します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Select |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Top
返されるレコードの最大数を指定します。
パラメーターのプロパティ
| 型: | System.Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 極限 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。