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

説明

新しいエンティティをグループに追加する

例

例 1: グループを作成する

New-AzADGroup -DisplayName $gname -MailNickname $nickname

グループの作成

パラメーター

-AcceptedSender

このグループに投稿または予定表イベントを作成できるユーザーまたはグループの一覧。このリストが空でない場合は、ここに記載されているユーザーまたはグループのみが投稿できます。構築するには、ACCEPTEDSENDER プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IMicrosoftGraphDirectoryObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AdditionalProperties

その他のパラメーター

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AppRoleAssignment

アプリケーションに対してグループに付与されているアプリロールを表します。 $expandをサポートします。構築するには、APPROLEASSIGNMENT プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Classification

グループの分類 (低、中、高のビジネスへの影響など) について説明します。このプロパティの有効な値は、テンプレート定義に基づいて ClassificationList 設定値を作成することによって定義されます。既定で返されます。 $filter (eq、ne、NOT、ge、le、startsWith) をサポートします。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CreatedOnBehalfOf

Azure Active Directory オブジェクトを表します。 directoryObject 型は、他の多くのディレクトリエンティティ型の基本型です。構築するには、CREATEDONBEHALFOF プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IMicrosoftGraphDirectoryObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeletedDateTime

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

グループの説明 (省略可能)。既定で返されます。 $filter (eq、ne、NOT、ge、le、startsWith) と$searchをサポートします。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisplayName

グループの表示名。このプロパティは、グループが作成されるときに必要であり、更新中にクリアすることはできません。既定で返されます。 $filter (eq、ne、NOT、ge、le、in、startsWith)、$search、$orderByをサポートします。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GroupType

グループの種類とそのメンバーシップを指定します。コレクションに Unified が含まれている場合、グループは Microsoft 365 グループです。それ以外の場合は、セキュリティグループまたは配布グループです。詳細については、グループの概要を参照してください。コレクションに DynamicMembership が含まれている場合、グループには動的メンバーシップがあります。それ以外の場合、メンバーシップは静的です。既定で返されます。 $filter (eq、NOT) をサポートします。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-HasMembersWithLicenseError

グループベースのライセンス割り当てでライセンスエラーが発生したメンバーがこのグループに存在するかどうかを示します。このプロパティは、GET 操作では返されません。これを$filter引数として使用して、ライセンスエラーのあるメンバーを持つグループを取得できます (つまり、このプロパティを true にフィルター処理します)。 $filter (eq) をサポートします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsArchived

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsAssignableToRole

このグループを Azure Active Directory ロールに割り当てることができるかどうかを示します。このプロパティは、グループの作成時にのみ設定でき、変更できません。 true に設定した場合、securityEnabled プロパティも true に設定する必要があり、グループを動的グループにすることはできません (つまり、groupTypes に DynamicMembership を含めることはできません)。このプロパティを設定できるのは、グローバル管理者ロールと特権ロール管理者ロールの呼び出し元だけです。このプロパティを設定するには、呼び出し元に Directory.AccessAsUser.All アクセス許可も割り当てる必要があります。詳細については、「グループを使用して Azure AD ロールの割り当てを管理する」を参照してください。既定で戻されます。 $filter (eq、ne、NOT) をサポートします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MailEnabled

グループがメール対応かどうかを指定します。既定で返されます。 $filter (eq、ne、NOT) をサポートします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MailNickname

組織内で一意のグループのメールエイリアス。このプロパティは、グループの作成時に指定する必要があります。これらの文字は mailNickName: @()/[]':で使用できません。<>、SPACE。既定で返されます。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MembershipRule

グループが動的グループの場合にこのグループのメンバーを決定するルール (groupTypes には DynamicMembership が含まれています)。メンバーシップルールの構文の詳細については、「メンバーシップルールの構文」を参照してください。既定で返されます。 $filter (eq、ne、NOT、ge、le、startsWith) をサポートします。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MembershipRuleProcessingState

動的メンバーシップ処理がオンか一時停止かを示します。有効な値は[オン]または[一時停止]です。既定で返されます。 $filter (eq、ne、NOT、in) をサポートします。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PermissionGrant

特定のアプリケーションに対してグループに付与されたアクセス許可。 $expandをサポートします。構築するには、PERMISSIONGRANT プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IMicrosoftGraphResourceSpecificPermissionGrant[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PreferredDataLocation

グループの優先されるデータの場所。詳細については、「OneDrive Online Multi-Geo」を参照してください。既定で返されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PreferredLanguage

Microsoft 365 グループの優先言語。 ISO 639-1 コードに従う必要があります。たとえば、'en-US' などです。既定で返されます。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SecurityEnabled

グループがセキュリティグループかどうかを指定します。既定で返されます。 $filter (eq、ne、NOT、in) をサポートします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SecurityIdentifier

Windows シナリオで使用されるグループのセキュリティ識別子。既定で返されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Theme

Microsoft 365 グループのカラーテーマを指定します。指定できる値は、Teal、Purple、Green、Blue、Pink、Orange、Red です。既定で返されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TransitiveMember

. 構築するには、TRANSITIVEMEMBER プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IMicrosoftGraphDirectoryObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TransitiveMemberOf

. 構築するには、TRANSITIVEMEMBEROF プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IMicrosoftGraphDirectoryObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Visibility

グループのグループ参加ポリシーとグループコンテンツの可視性を指定します。使用可能な値は、Private、Public、または Hiddenmembership です。 Hiddenmembership は、グループの作成時に Microsoft 365 グループに対してのみ設定できます。後で更新することはできません。その他の可視性の値は、グループの作成後に更新できます。 Microsoft Graph でのグループの作成時に可視性の値が指定されていない場合、セキュリティグループは既定でプライベートとして作成され、Microsoft 365 グループはパブリックになります。詳細については、グループの表示オプションを参照してください。既定で返されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

IMicrosoftGraphGroup

次の方法で共有