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>]

Description

Get-MsolRoleMember Cmdlet 會取得指定角色的成員。

範例

範例 1：取得角色的成員

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

此命令會傳回指定角色的所有成員。 命令會將結果儲存在 $RoleMembers 變數中。

參數

-All

指出此 Cmdlet 會傳回它找到的所有結果。 請勿指定此參數和 MaxResults 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MaxResults

指定這個 Cmdlet 傳回的結果數目上限。 預設值為 250。

類型:	Int32
Position:	Named
預設值:	250
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MemberObjectTypes

指定成員物件類型的陣列。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RoleObjectId

指定要從中移除成員之角色的唯一標識碼。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SearchString

指定字串。 此 Cmdlet 會傳回顯示名稱或以這個字串開頭的電子郵件地址的物件。 要搜尋的字串。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TenantId

指定要在其中執行作業之租使用者的唯一標識符。 預設值為目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

輸出

Microsoft.Online.Administation.RoleMember

此 Cmdlet 會傳回包含下列資訊的角色成員物件：

• DisplayName。 角色成員的顯示名稱。

• EmailAddress。 角色成員的電子郵件地址。

• IsLicensed。 使用者是否具有授權。

• LastDirSyncTime。 上次同步處理此成員的日期和時間。

• ObjectId。 成員的唯一識別碼。

• OverallProvisioningStatus。 這個使用者的佈建狀態。

• RoleMemberType。 角色成員的類型。 目前僅支援「使用者」。

• ValidationStatus。 此群組成員是否有任何錯誤。

相關連結

• Add-MsolRoleMember
• Remove-MsolRoleMember