Get-MsolScopedRoleMember

管理単位に対してそのロールが付与されているロールのメンバーを取得します。

構文

Get-MsolScopedRoleMember
   [-AdministrativeUnitObjectId <Guid>]
   [-RoleObjectId <Guid>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolScopedRoleMember
   [-AdministrativeUnitObjectId <Guid>]
   [-RoleObjectId <Guid>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

説明

Get-MsolScopedRoleMember コマンドレットは、管理単位に対してそのロールが付与されている、指定されたロールのメンバーを取得します。

例 1: ユーザー アカウント管理者ロールのメンバーを取得する

PS C:\> $WestCoastAu = Get-MsolAdministrativeUnit -SearchString "West Coast"
PS C:\> $UaAdmin = Get-MsolRole -RoleName "User Account Administrator"
PS C:\> Get-MsolScopedRoleMember -RoleObjectId $UaAdmin.ObjectId -AdministrativeUnitObjectId $WestCoastAu.ObjectId

この例では、West Coast という名前の管理単位をスコープとするユーザー アカウント管理者ロールのすべてのメンバーを取得します。

パラメーター

-AdministrativeUnitObjectId

管理単位の一意のオブジェクト ID を指定します。 このパラメーターを指定しない場合、このコマンドレットはすべての管理単位の管理者を取得します。

型:Guid
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-All

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

型:SwitchParameter
Position:Named
既定値:None
必須:True
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

このコマンドレットが返す結果の最大数を指定します。

型:Int32
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleObjectId

メンバーを取得するロールの一意のオブジェクト ID を指定します。

型:Guid
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

型:Guid
Position:Named
既定値:None
必須:False
Accept pipeline input:True
Accept wildcard characters:False

出力

Microsoft.Online.Administration.RoleScopedMember

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

  • DisplayName。 スコープ付きロール メンバーの表示名。
  • UserPrincipalName。 スコープ付きロール メンバーのユーザー プリンシパル名。
  • Objectid。 スコープ付きロール メンバーの一意の ID。