Get-EntraDirectoryRoleMember

モジュール:
Microsoft.Entra.DirectoryManagement Module v1.3

ディレクトリ ロールのメンバーを取得します。

構文

Default (既定) 

Get-EntraDirectoryRoleMember

    -DirectoryRoleId <String>
    [-Property <String[]>]
    [<CommonParameters>]

説明

Get-EntraDirectoryRoleMember コマンドレットは、Microsoft Entra IDのディレクトリ ロールのメンバーを取得します。 特定のディレクトリ ロールのメンバーを取得するには、 DirectoryRoleIdを指定します。 Get-EntraDirectoryRole値を取得するには、DirectoryRoleId コマンドレットを使用します。

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 この操作では、次の最小特権ロールがサポートされています。

  • ユーザー管理者
  • ヘルプデスク管理者
  • サービス サポート管理者
  • 請求管理者
  • ディレクトリの読み手
  • ディレクトリ製作者
  • アプリケーション管理者
  • セキュリティリーダー
  • セキュリティ管理者
  • 特権ロール管理者
  • クラウド アプリケーション管理者

例

例 1: ロール ID でメンバーを取得する

Connect-Entra -Scopes 'RoleManagement.Read.Directory'
$directoryRole = Get-EntraDirectoryRole -Filter "displayName eq 'Helpdesk Administrator'"
Get-EntraDirectoryRoleMember -DirectoryRoleId $directoryRole.Id | Select Id, DisplayName, '@odata.type', CreatedDateTime

id                                   displayName     @odata.type            createdDateTime
--                                   -----------     -----------            ---------------
bbbbbbbb-7777-8888-9999-cccccccccccc Debra Berger    #microsoft.graph.user  10/7/2024 12:31:57 AM
cccccccc-2222-3333-4444-dddddddddddd Contoso Group   #microsoft.graph.group 11/12/2024 9:59:43 AM

次の使用例は、指定したロールのメンバーを取得します。

  • -DirectoryRoleId パラメーターはディレクトリ ロール ID を指定します。

パラメーター

-DirectoryRoleId

Microsoft Entra IDのディレクトリ ロールの ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Property

返されるプロパティを指定します。

パラメーターのプロパティ

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。