你当前正在访问 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
输出
备注
请参阅 New-AzureADMSGroup 到 Microsoft Graph PowerShell 的迁移指南。
此 cmdlet 目前为公共预览版。 当 cmdlet 处于公共预览版时,我们可能会对 cmdlet 进行更改,这可能会产生意外的影响。 建议不要在生产环境中使用此 cmdlet。