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

New-AzureADMSGroup

创建 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

指定组的说明。

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

-DisplayName

指定组的显示名称。

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

-GroupTypes

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

注意:

  • 此参数当前不能用于创建动态组。 若要在 PowerShell 中创建动态组,必须使用 Azure AD 预览版模块。
类型:List<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IsAssignableToRole

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

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

-MailEnabled

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

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

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

-MailNickname

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

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

-SecurityEnabled

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

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

-Visibility

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

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

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

注意:

  • 此参数仅对 groupType 设置为“Unified”的组有效。
  • 如果组将此属性设置为“HiddenMembership”,则以后无法更改此属性。
  • 任何人都可以加入此属性设置为“Public”的组。 如果属性设置为 Private 或 HiddenMembership,则只有所有者 () 可以向组添加新成员,并且加入组的请求需要所有者 () 的批准。
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

Object

备注

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

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