New-AzADGroup

语法

Default （默认值）

New-AzADGroup
    -DisplayName <String>
    -MailNickname <String>
    [-AcceptedSender <IMicrosoftGraphDirectoryObject[]>]
    [-AdditionalProperties <Hashtable>]
    [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
    [-Classification <String>]
    [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-GroupType <String[]>]
    [-HasMembersWithLicenseError]
    [-IsArchived]
    [-IsAssignableToRole]
    [-MailEnabled]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
    [-PreferredDataLocation <String>]
    [-PreferredLanguage <String>]
    [-SecurityEnabled]
    [-SecurityIdentifier <String>]
    [-Theme <String>]
    [-TransitiveMember <IMicrosoftGraphDirectoryObject[]>]
    [-TransitiveMemberOf <IMicrosoftGraphDirectoryObject[]>]
    [-Visibility <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

示例

示例 1：创建组

New-AzADGroup -DisplayName $gname -MailNickname $nickname

参数

-AcceptedSender

允许在此组中创建帖子或日历事件的用户或组的列表。 如果此列表不为空，则仅允许在此处列出的用户或组发布。 若要构造，请参阅 ACCEPTEDSENDER 属性的 NOTES 部分并创建哈希表。

参数属性

参数集

-AdditionalProperties

其他参数

参数属性

参数集

-AppRoleAssignment

表示已为应用程序授予组的应用角色。 支持$expand。 若要构造，请参阅 APPROLEASSIGNMENT 属性的 NOTES 部分并创建哈希表。

参数属性

参数集

-Classification

描述组的分类（如低、中或高业务影响）。 通过基于模板定义创建 ClassificationList 设置值来定义此属性的有效值。默认返回。 支持$filter（eq、ne、NOT、ge、le、startsWith）。

参数属性

参数集

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

参数集

-CreatedOnBehalfOf

表示 Azure Active Directory 对象。 directoryObject 类型是许多其他目录实体类型的基类型。 若要构造，请参阅 CREATEDONBEHALFOF 属性的 NOTES 部分并创建哈希表。

参数属性

参数集

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

参数集

-DeletedDateTime

.

参数属性

参数集

-Description

组的可选说明。 默认情况下返回。 支持$filter（eq、ne、NOT、ge、le、startsWith）和$search。

参数属性

参数集

-DisplayName

组的显示名称。 创建组且在更新期间无法清除时，此属性是必需的。 默认情况下返回。 支持$filter（eq、ne、NOT、ge、le、in、startsWith）、$search和$orderBy。

参数属性

参数集

-GroupType

指定组类型及其成员身份。 如果集合包含 Unified，则组为 Microsoft 365 组;否则，它是安全组或通讯组。 有关详细信息，请参阅组概述。如果集合包含 DynamicMembership，则组具有动态成员身份;否则，成员身份是静态的。 默认情况下返回。 支持$filter（eq、NOT）。

参数属性

参数集

-HasMembersWithLicenseError

指示此组中是否有成员在其基于组的许可证分配中出现许可证错误。 此属性永远不会在 GET作上返回。 可以使用它作为$filter参数来获取具有许可证错误的成员的组（即，筛选此属性为 true）。 支持$filter（eq）。

参数属性

参数集

-IsArchived

.

参数属性

参数集

-IsAssignableToRole

指示是否可以将此组分配到 Azure Active Directory 角色。只能在创建组时设置此属性，并且是不可变的。 如果设置为 true，则 securityEnabled 属性也必须设置为 true，并且该组不能是动态组（也就是说，groupTypes 不能包含 DynamicMembership）。 只有全局管理员和特权角色管理员角色中的调用方才能设置此属性。 还必须为调用方分配 Directory.AccessAsUser.All 权限才能设置此属性。 有关详细信息，请参阅默认使用组管理 Azure AD 角色分配。 支持$filter（eq、ne、NOT）。

参数属性

参数集

-MailEnabled

指定组是否启用邮件。 默认情况下返回。 支持$filter（eq、ne、NOT）。

参数属性

参数集

-MailNickname

组的邮件别名，在组织中是唯一的。 创建组时必须指定此属性。 这些字符不能用于 mailNickName： @（）/[];;：.<>，SPACE。 默认情况下返回。 支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

参数属性

参数集

-MembershipRule

如果组是动态组（groupTypes 包含 DynamicMembership），则确定此组的成员的规则。 有关成员资格规则语法的详细信息，请参阅成员资格规则语法。 默认情况下返回。 支持$filter（eq、ne、NOT、ge、le、startsWith）。

参数属性

参数集

-MembershipRuleProcessingState

指示动态成员身份处理是打开还是暂停。 可能的值为 On 或 Paused。 默认情况下返回。 支持$filter（eq、ne、NOT、in）。

参数属性

参数集

-PermissionGrant

已向特定应用程序授予组的权限。 支持$expand。 若要构造，请参阅 PERMISSIONGRANT 属性的 NOTES 部分并创建哈希表。

参数属性

参数集

-PreferredDataLocation

组的首选数据位置。 有关详细信息，请参阅 OneDrive Online 多地理位置。 默认情况下返回。

参数属性

参数集

-PreferredLanguage

Microsoft 365 组的首选语言。 应遵循 ISO 639-1 代码;例如“en-US”。 默认情况下返回。 支持 $filter （eq， ne， NOT， ge， le， in， startsWith）。

参数属性

参数集

-SecurityEnabled

指定组是否为安全组。 默认情况下返回。 支持$filter（eq、ne、NOT、in）。

参数属性

参数集

-SecurityIdentifier

在 Windows 方案中使用的组的安全标识符。 默认情况下返回。

参数属性

参数集

-Theme

指定Microsoft 365 组的颜色主题。 可能的值为 Teal、紫色、绿色、蓝色、粉红色、橙色或红色。 默认情况下返回。

参数属性

参数集

-TransitiveMember

. 若要构造，请参阅 TRANSITIVEMEMBER 属性的 NOTES 部分并创建哈希表。

参数属性

参数集

-TransitiveMemberOf

. 若要构造，请参阅 TRANSITIVEMEMBEROF 属性的 NOTES 部分，并创建哈希表。

参数属性

参数集

-Visibility

指定组的组策略和组内容可见性。 可能的值为：Private、Public 或 Hiddenmembership。 创建组时，只能为Microsoft 365 个组设置 Hiddenmembership。 以后无法更新它。 组创建后，可以更新其他可见性值。 如果在 Microsoft Graph 上的组创建期间未指定可见性值，则默认情况下会创建安全组，Microsoft 365 组为 Public。 有关详细信息，请参阅组可见性选项。 默认情况下返回。

参数属性

参数集

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

参数集

CommonParameters

输出

IMicrosoftGraphGroup