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

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

パラメーターのプロパティ

パラメーター セット

-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

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

パラメーターのプロパティ

パラメーター セット

-PermissionGrant

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

パラメーターのプロパティ

パラメーター セット

-PreferredDataLocation

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

パラメーターのプロパティ

パラメーター セット

-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、Purple、Green、Blue、Pink、Orange、Red です。 既定で返されます。

パラメーターのプロパティ

パラメーター セット

-TransitiveMember

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

パラメーターのプロパティ

パラメーター セット

-TransitiveMemberOf

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

パラメーターのプロパティ

パラメーター セット

-Visibility

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

パラメーターのプロパティ

パラメーター セット

-WhatIf

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

パラメーターのプロパティ

パラメーター セット

CommonParameters

出力

IMicrosoftGraphGroup