New-AzADGroup
新しいエンティティをグループに追加する
構文
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 グループの優先言語。 ISO639-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 |
出力
メモ
別名
複合パラメーターのプロパティ
以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。
ACCEPTEDSENDER <IMicrosoftGraphDirectoryObject[]>: このグループに投稿または予定表イベントを作成できるユーザーまたはグループの一覧。 このリストが空でない場合は、ここに記載されているユーザーまたはグループのみが投稿できます。
[DeletedDateTime <DateTime?>]
:[DisplayName <String>]
: ディレクトリに表示される名前
APPROLEASSIGNMENT <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>: アプリケーションに対してグループが付与されたアプリ ロールを表します。 $expandをサポートします。
[DeletedDateTime <DateTime?>]
:[DisplayName <String>]
: ディレクトリに表示される名前[AppRoleId <String>]
: プリンシパルに割り当てられているアプリ ロールの識別子 (ID)。 このアプリ ロールは、リソース アプリケーションのサービス プリンシパル (resourceId) の appRoles プロパティで公開する必要があります。 リソース アプリケーションがアプリ ロールを宣言していない場合は、既定のアプリ ロール ID 00000000-0000-0000-000000000000 を指定して、プリンシパルが特定のアプリ ロールなしでリソース アプリに割り当てられていることを通知できます。 作成時に必要です。[CreatedDateTime <DateTime?>]
: アプリ ロールの割り当てが作成された時刻。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日の午前 0 時 (UTC) は 2014-01-01T00:00:00Z です。 読み取り専用です。[PrincipalDisplayName <String>]
: アプリ ロールの割り当てが付与されたユーザー、グループ、またはサービス プリンシパルの表示名。 読み取り専用です。 $filter (eq と startswith) をサポートします。[PrincipalId <String>]
: アプリ ロールが付与されているユーザー、グループ、またはサービス プリンシパルの一意識別子 (ID)。 作成時に必要です。[PrincipalType <String>]
: 割り当てられたプリンシパルの型。 User、Group、ServicePrincipal のいずれかを指定できます。 読み取り専用です。[ResourceDisplayName <String>]
: 割り当てが行われるリソース アプリのサービス プリンシパルの表示名。[ResourceId <String>]
: 割り当てが行われるリソース サービス プリンシパルの一意識別子 (ID)。 作成時に必要です。 $filterをサポートします (eq のみ)。
CREATEDONBEHALFOF <IMicrosoftGraphDirectoryObject>
: Azure Active Directory オブジェクトを表します。 directoryObject 型は、他の多くのディレクトリ エンティティ型の基本型です。
[DeletedDateTime <DateTime?>]
:[DisplayName <String>]
: ディレクトリに表示される名前
PERMISSIONGRANT <IMicrosoftGraphResourceSpecificPermissionGrant[]>: 特定のアプリケーションに対してグループに付与されたアクセス許可。 $expandをサポートします。
[DeletedDateTime <DateTime?>]
:[DisplayName <String>]
: ディレクトリに表示される名前[ClientAppId <String>]
: アクセス権が付与されている Azure AD アプリのサービス プリンシパルの ID。 読み取り専用です。[ClientId <String>]
: アクセス権が付与されている Azure AD アプリの ID。 読み取り専用です。[Permission <String>]
: リソース固有のアクセス許可の名前。 読み取り専用です。[PermissionType <String>]
: アクセス許可の種類。 使用可能な値は、Application、Delegated です。 読み取り専用です。[ResourceAppId <String>]
: リソースをホストしている Azure AD アプリの ID。 読み取り専用です。
TRANSITIVEMEMBER <IMicrosoftGraphDirectoryObject[]>: .
[DeletedDateTime <DateTime?>]
:[DisplayName <String>]
: ディレクトリに表示される名前
TRANSITIVEMEMBEROF <IMicrosoftGraphDirectoryObject[]>: .
[DeletedDateTime <DateTime?>]
:[DisplayName <String>]
: ディレクトリに表示される名前