你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-MsolRoleMember

获取角色的成员。

语法

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 cmdlet 获取指定角色的成员。

示例

示例 1:获取角色的成员

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

此命令返回指定角色的所有成员。 此命令将结果存储在$RoleMembers变量中。

参数

-All

指示此 cmdlet 返回它找到的所有结果。 请勿指定此参数和 MaxResults 参数。

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

-MaxResults

指定此 cmdlet 返回的最大结果数。 默认值为 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

指定字符串。 此 cmdlet 返回显示名称或电子邮件地址以此字符串开头的对象。 要搜索的字符串。

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

此 cmdlet 返回包含以下信息的角色成员对象:

  • DisplayName。 角色成员的显示名称。

  • EmailAddress。 角色成员的电子邮件地址。

  • IsLicensed。 该用户是否已获授权。

  • LastDirSyncTime。 上次同步此成员的日期和时间。

  • ObjectId。 成员的唯一 ID。

  • OverallProvisioningStatus。 此用户的设置状态。

  • RoleMemberType。 角色成员的类型。 目前仅支持“User”。

  • ValidationStatus。 此组成员是否存在任何错误。