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

New-AzureADMSGroup

  • 参考
模块:
AzureAD

创建 Azure AD 组。

语法

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

说明

New-AzureADMSGroup cmdlet (Azure AD) 组创建 Azure Active Directory。

示例

示例：创建可分配给角色的组

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

参数

-Description

指定组的说明。

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

-DisplayName

指定组的显示名称。

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

-GroupTypes

指定组是统一组或动态组。

注意：

  • 此参数当前不能用于创建动态组。 若要在 PowerShell 中创建动态组，必须使用 Azure AD 预览版模块。
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

指示是否可以将组分配给角色。 此属性只能在创建组时设置，不能在现有组上修改。

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

-MailEnabled

指示此组是否已启用邮件。

目前，无法在 Azure AD 中创建已启用邮件的组。

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

-MailNickname

指定组的邮件昵称。 如果 MailEnabled 为 $False则仍必须指定邮件昵称。

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

-SecurityEnabled

指示组是否已启用安全性。 对于安全组，此值必须$True。

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

-Visibility

指定组的内容和成员列表的可见性。 此参数可以采用以下值之一：

  • “公共” - 任何人都可以查看组的内容
  • “专用” - 只有成员才能查看组的内容
  • “HiddenMembership”- 只有成员可以查看组的内容，只有成员、所有者、全局/公司管理员、用户管理员和技术支持管理员可以查看组的成员列表。

如果未提供任何值，则默认值为“Public”。

注意：

  • 此参数仅对 groupType 设置为“Unified”的组有效。
  • 如果组将此属性设置为“HiddenMembership”，则以后无法更改此属性。
  • 任何人都可以加入此属性设置为“Public”的组。 如果属性设置为 Private 或 HiddenMembership，则只有所有者 () 可以向组添加新成员，并且加入组的请求需要所有者 () 的批准。
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

输出

Object

备注

请参阅 New-AzureADMSGroup 到 Microsoft Graph PowerShell 的迁移指南。

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