通过

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

Get-AzureADMSGroup

  • 参考
模块:
AzureADPreview

获取有关 Azure AD 中的组的信息。

语法

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Select <String>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [-Select <String>]
   [<CommonParameters>]

说明

Get-AzureADMSGroup cmdlet 获取有关 Azure Active Directory (Azure AD) 中的组的信息。 若要获取组，请指定 Id 参数。 指定 SearchString 或 Filter 参数以查找特定组。 如果未指定参数，则此 cmdlet 将获取所有组。

示例

示例 1：获取所有组

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : 
ADSyncOperators 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False
MailNickname                  : ADSyncOperators 
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {} 
MembershipRule                : 
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

此命令获取 Azure AD 中的所有组。

示例 2：使用 ID 获取特定组

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

此命令获取具有指定 ID 的组的信息。

示例 3：获取所有组的 AssignedLabels 和 DisplayName 属性值

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

此命令获取所有组的 AssignedLabels 和 DisplayName 属性值。

AssignedLabels 组属性只能由 Select 参数检索。

示例 4：获取组的 AssignedLabels 和 DisplayName 属性值

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

此命令获取特定组的 AssignedLabels 和 DisplayName 属性值。

AssignedLabels 组属性只能由 Select 参数检索。

参数

-All

如果为 true，则返回所有组。 如果为 false，则返回 Top 参数指定的对象数

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Filter

指定 oData v3.0 筛选器字符串以匹配一组组。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Id

指定此 cmdlet 获取的组的 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SearchString

指定搜索字符串。 此 cmdlet 获取具有与搜索字符串匹配的 DisplayName 或 Description 属性的组。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Select

指定要检索的组属性的列表。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Top

指定此 cmldet 获取的最大记录数。 默认值为 100。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

String

System.Nullable'1[[System.Int32， mscorlib， Version=4.0.0.0， Culture=neutral， PublicKeyToken=b77a5c561934e089]]

输出

Object

备注

此 cmdlet 目前为公共预览版。 当 cmdlet 处于公共预览版时，我们可能会对 cmdlet 进行更改，这可能会产生意外的影响。 建议不要在生产环境中使用此 cmdlet。