New-AzADGroup

模組:

Az.Resources

將新的實體新增至群組

語法

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

Description

將新的實體新增至群組

範例

範例 1：建立群組

New-AzADGroup -DisplayName $gname -MailNickname $nickname

建立群組

參數

-AcceptedSender

允許在此群組中建立張貼或行事曆事件的使用者或群組清單。 如果這份清單不是空的，則只允許張貼此處所列的使用者或群組。 若要建構，請參閱 ACCEPTEDSENDER 屬性的 NOTES 區段並建立哈希表。

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

-AdditionalProperties

其他參數

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

-AppRoleAssignment

代表已為應用程式授與群組的應用程式角色。 支援$expand。 若要建構，請參閱APPROLEASSIGNMENT屬性的NOTES區段，並建立哈希表。

類型:	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 類型是許多其他目錄實體類型的基底類型。 若要建構，請參閱 CREATEDONBEHALFOF 屬性的 NOTES 區段並建立哈希表。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	PSObject
別名:	AzContext, 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

群組的顯示名稱。 建立群組且無法在更新期間清除時，需要這個屬性。 預設會傳回 。 支援$filter（eq、ne、NOT、ge、le、in、startsWith）、$search和$orderBy。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	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

-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
必要:	True
接受管線輸入:	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

-PermissionGrant

已為群組授與給特定應用程式的許可權。 支援$expand。 若要建構，請參閱 PERMISSIONGRANT 屬性的 NOTES 區段並建立哈希表。

類型:	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

-TransitiveMember

. 若要建構，請參閱 NOTES 一節的 TRANSITIVEMEMBER 屬性並建立哈希表。

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

-TransitiveMemberOf

. 若要建構，請參閱 TRANSITIVEMEMBEROF 屬性的 NOTES 區段並建立哈希表。

類型:	IMicrosoftGraphDirectoryObject[]
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

輸出

IMicrosoftGraphGroup