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

New-AzureADMSGroup

创建 Azure AD 组。

语法

Default (默认值)

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 Active Directory (Azure AD) 组。

示例

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

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
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisplayName

指定组的显示名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-GroupTypes

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

注释:

  • 此参数目前不能用于创建动态组。 若要在 PowerShell 中创建动态组,必须使用 Azure AD 预览版模块。

参数属性

类型:

List<T>[String]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IsAssignableToRole

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MailEnabled

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

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MailNickname

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SecurityEnabled

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Visibility

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

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

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

注释:

  • 此参数仅对 groupType 设置为“Unified”的组有效。
  • 如果组将此属性设置为“HiddenMembership”,则以后无法更改。
  • 任何人都可以加入将此属性设置为“公共”的组。 如果属性设置为 Private 或 HiddenMembership,则只有所有者才能向组添加新成员,并且加入组的请求需要所有者的批准。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

输出

Object

备注

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

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