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

Update-AzADGroup

模块:

Az.Resources

更新组中的实体

语法

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

Update-AzADGroup
      -ObjectId <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADGroup
      -ObjectId <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

更新组中的实体

示例

示例 1：组的更新说明

Update-AzADGroup -ObjectId $objectid -Description $description

更新组的说明。

参数

-AdditionalProperties

其他参数

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

-AppRoleAssignment

表示已为应用程序授予组的应用角色。 支持$expand。

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

-Classification

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

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

-Confirm

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

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

-CreatedOnBehalfOf

表示 Azure Active Directory 对象。 directoryObject 类型是许多其他目录实体类型的基类型。

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

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeletedDateTime

.

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

-Description

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

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

-DisplayName

目录中显示的名称

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

-GroupType

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

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

-HasMembersWithLicenseError

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

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

-IsArchived

.

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

-IsAssignableToRole

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

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

-JsonFilePath

提供给更新操作的 Json 文件的路径

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

-JsonString

提供给更新操作的 Json 字符串

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

-MailEnabled

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

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

-MailNickname

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

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

-MembershipRule

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

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

-MembershipRuleProcessingState

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

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

-ObjectId

键：组 ID

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

-PassThru

当命令成功时返回 true

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

-PermissionGrant

已向特定应用程序授予组的权限。 支持$expand。

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

-PreferredDataLocation

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

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

-PreferredLanguage

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

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

-SecurityEnabled

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

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

-SecurityIdentifier

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

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

-Theme

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

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

-Visibility

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

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

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

输出

Boolean