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>]

Description

更新群組中的實體

範例

範例 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

機碼：群組的標識碼

類型:	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 上的群組建立期間未指定可見度值，安全組預設會建立為 Private，Microsoft 365 群組為 Public。 若要深入瞭解，請參閱群組可見度選項。 預設會傳回 。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

Boolean