Update-AzADGroup
グループ内のエンティティを更新する
構文
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>] 説明
グループ内のエンティティを更新する
例
例 1: グループの説明を更新する
Update-AzADGroup -ObjectId $objectid -Description $descriptionグループの説明を更新します。
パラメーター
-AdditionalProperties
その他のパラメーター
| 型: | Hashtable |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AppRoleAssignment
アプリケーションに対してグループに付与されているアプリ ロールを表します。 $expandをサポートします。
| 型: | 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 型は、他の多くのディレクトリ エンティティ型の基本型です。
| 型: | IMicrosoftGraphDirectoryObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。
| 型: | PSObject |
| Aliases: | 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
ディレクトリに表示される名前
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | 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 |
-JsonFilePath
更新操作に指定された Json ファイルのパス
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JsonString
更新操作に指定された Json 文字列
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | 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 |
| 必須: | False |
| パイプライン入力を受け取る: | 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 |
-ObjectId
キー: グループの ID
| 型: | String |
| Aliases: | GroupId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
コマンドが成功したときに true を返します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PermissionGrant
特定のアプリケーションに対してグループに付与されたアクセス許可。 $expandをサポートします。
| 型: | 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 |
-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 |
出力
Azure PowerShell