Get-MsolRoleMember

  • リファレンス
モジュール:
MSOnline

ロールのメンバーを取得します。

構文

Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

説明

Get-MsolRoleMember コマンドレットは、指定されたロールのメンバーを取得します。

例

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

PS C:\> $Role = Get-MsolRole -RoleName "%Role Name%"
PS C:\> $RoleMembers = Get-MsolRoleMember -RoleObjectId $Role.ObjectId

このコマンドは、指定されたロールのすべてのメンバーを返します。 このコマンドは、結果を$RoleMembers変数に格納します。

パラメーター

-All

このコマンドレットは、検出されたすべての結果を返します。 このパラメーターと MaxResults パラメーターは 指定しないでください。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

このコマンドレットから返される結果の最大数を指定します。 既定値は 250 です。

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberObjectTypes

メンバー オブジェクト型の配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleObjectId

メンバーを削除するロールの一意の ID を指定します。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

文字列を指定します。 このコマンドレットは、この文字列で始まる表示名または電子メール アドレスを持つオブジェクトを返します。 検索対象の文字列。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

Microsoft.Online.Administation.RoleMember

このコマンドレットは、次の情報を含むロール メンバー オブジェクトを返します。

  • DisplayName。 ロール メンバーの表示名。

  • Emailaddress。 ロール メンバーの電子メール アドレス。

  • IsLicensed。 ユーザーにライセンスがあるかどうか。

  • LastDirSyncTime。 このメンバーが最後に同期された日時。

  • Objectid。 メンバーの一意の ID。

  • OverallProvisioningStatus。 このユーザーのプロビジョニングのステータス。

  • RoleMemberType。 ロール メンバーの種類。 現在は "User" のみがサポートされています。

  • ValidationStatus。 このグループ メンバーについてエラーがあるかどうか。