az maintenance configuration

Note

このリファレンスは、Azure CLI (バージョン 2.56.0 以降) のメインテナント拡張機能の一部です。 拡張機能は、az メインtenance 構成コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

メインテナントを使用して、メインテナント構成を管理します。

コマンド

名前	説明	型	Status
az maintenance configuration create	構成レコードを作成します。	拡張子	GA
az maintenance configuration delete	構成レコードを削除します。	拡張子	GA
az maintenance configuration list	サブスクリプションとリソース グループ内の構成レコードを一覧表示します。	拡張子	GA
az maintenance configuration show	構成レコードを取得します。	拡張子	GA
az maintenance configuration update	構成レコードを更新します。	拡張子	GA

az maintenance configuration create

構成レコードを作成します。

az maintenance configuration create --name
                                    --resource-group
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--tags]
                                    [--visibility {Custom, Public}]

例

MaintenanceConfigurations_CreateOrUpdateForResource

az maintenance configuration create --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Day" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

必須のパラメーター

--name --resource-name -n

メンテナンス構成名。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--duration --maintenance-window-duration

HH:mm 形式のメンテナンス期間。 指定しない場合は、指定されたメンテナンス範囲に基づいて既定値が使用されます。 例: 05:00。.

--expiration-date-time --maintenance-window-expiration-date-time

メンテナンス期間の有効な有効期限 (YYYY-MM-DD hh:mm 形式)。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 有効期限は、将来の日付に設定する必要があります。 指定しない場合は、最大日時 9999-12-31 23:59:59 に設定されます。

--extension-properties

メインtenanceConfiguration Support の shorthand-syntax、json-file、yaml-file の extensionProperties を取得または設定します。 詳細を表示するには、"??" を試してください。

--install-patches-linux-parameters --linux-parameters

Linux マシンの修正プログラムの適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--install-patches-windows-parameters --windows-parameters

Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--location -l

リソースの場所を取得または設定します。

--maintenance-scope

構成メインtenanceScope を取得または設定します。

承認された値: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance

--maintenance-window-recur-every --recur-every

メンテナンス期間が繰り返されると予想されるレート。 レートは日、週、月のスケジュールで表すことができます。 毎日のスケジュールは recurEvery として書式設定されます: [頻度 (整数値)]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 日単位のスケジュールの例を示すと、recurEvery: Day、recurEvery: 3Days となります。 週間スケジュールは recurEvery : [頻度 (整数値)]['Week(s)'] [月曜日から日曜日までの平日をカンマで区切ったリスト(オプション)] として書式設定されます。 週単位のスケジュールの例は、recurEvery: 3Weeks、recurEvery: Week Saturday、Sunday です。 月単位のスケジュールは、[Frequency as integer]['Month(s)'] [Comma separated list of month days] または [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]の形式で書式設定されます。 オフセット値は、-6 ~ 6 の範囲にする必要があります。 月次スケジュールの例は、繰り返しです。Month、recurEvery:2Months、recurEvery: Month day23,day24、recurEvery: Month Last Sunday、recurEvery: Month Fourth Monday、recurEvery: Month Last Sunday Offset-3、recurEvery: Month Third Sunday Offset6。

--maintenance-window-start-date-time --start-date-time

メンテナンス期間の有効な開始日 (YYYY-MM-DD hh:mm 形式)。 開始日は、現在の日付または将来の日付に設定できます。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。

--maintenance-window-time-zone --time-zone

タイムゾーンの名前。 タイムゾーンの一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行することで取得できます。 例: 太平洋標準時、UTC、西ヨーロッパ標準時、韓国標準時、中央 オーストラリア標準時。

--namespace

リソースの名前空間を取得または設定します。

--reboot-setting

パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。

承認された値: Always, IfRequired, Never

--tags

リソースサポートの短縮構文、json-file、yaml-file のタグを取得または設定します。 詳細を表示するには、"??" を試してください。

--visibility

構成の可視性を取得または設定します。 既定値は 'Custom' です。

承認された値: Custom, Public

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az maintenance configuration delete

構成レコードを削除します。

az maintenance configuration delete [--ids]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

例

MaintenanceConfigurations_DeleteForResource

az maintenance configuration delete --resource-group "examplerg" --resource-name "example1"

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name --resource-name -n

メンテナンス構成名。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--yes -y

確認のダイアログを表示しません。

既定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az maintenance configuration list

サブスクリプションとリソース グループ内の構成レコードを一覧表示します。

az maintenance configuration list [--resource-group]

例

MaintenanceConfigurations_List

az maintenance configuration list

省略可能のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az maintenance configuration show

構成レコードを取得します。

az maintenance configuration show [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

例

MaintenanceConfigurations_GetForResource

az maintenance configuration show --resource-group "examplerg" --resource-name "configuration1"

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name --resource-name -n

メンテナンス構成名。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az maintenance configuration update

構成レコードを更新します。

az maintenance configuration update [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--name]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--resource-group]
                                    [--subscription]
                                    [--tags]
                                    [--visibility {Custom, Public}]

例

MaintenanceConfigurations_UpdateForResource

az maintenance configuration update --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Month Third Sunday" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

省略可能のパラメーター

--duration --maintenance-window-duration

HH:mm 形式のメンテナンス期間。 指定しない場合は、指定されたメンテナンス範囲に基づいて既定値が使用されます。 例: 05:00。.

--expiration-date-time --maintenance-window-expiration-date-time

メンテナンス期間の有効な有効期限 (YYYY-MM-DD hh:mm 形式)。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 有効期限は、将来の日付に設定する必要があります。 指定しない場合は、最大日時 9999-12-31 23:59:59 に設定されます。

--extension-properties

メインtenanceConfiguration Support の shorthand-syntax、json-file、yaml-file の extensionProperties を取得または設定します。 詳細を表示するには、"??" を試してください。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--install-patches-linux-parameters --linux-parameters

Linux マシンの修正プログラムの適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--install-patches-windows-parameters --windows-parameters

Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--location -l

リソースの場所を取得または設定します。

--maintenance-scope

構成メインtenanceScope を取得または設定します。

承認された値: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance

--maintenance-window-recur-every --recur-every

メンテナンス期間が繰り返されると予想されるレート。 レートは日、週、月のスケジュールで表すことができます。 毎日のスケジュールは recurEvery として書式設定されます: [頻度 (整数値)]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 日単位のスケジュールの例を示すと、recurEvery: Day、recurEvery: 3Days となります。 週間スケジュールは recurEvery : [頻度 (整数値)]['Week(s)'] [月曜日から日曜日までの平日をカンマで区切ったリスト(オプション)] として書式設定されます。 週単位のスケジュールの例は、recurEvery: 3Weeks、recurEvery: Week Saturday、Sunday です。 月単位のスケジュールは、[Frequency as integer]['Month(s)'] [Comma separated list of month days] または [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]の形式で書式設定されます。 オフセット値は、-6 ~ 6 の範囲にする必要があります。 月次スケジュールの例は、繰り返しです。Month、recurEvery:2Months、recurEvery: Month day23,day24、recurEvery: Month Last Sunday、recurEvery: Month Fourth Monday、recurEvery: Month Last Sunday Offset-3、recurEvery: Month Third Sunday Offset6。

--maintenance-window-start-date-time --start-date-time

メンテナンス期間の有効な開始日 (YYYY-MM-DD hh:mm 形式)。 開始日は、現在の日付または将来の日付に設定できます。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。

--maintenance-window-time-zone --time-zone

タイムゾーンの名前。 タイムゾーンの一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行することで取得できます。 例: 太平洋標準時、UTC、西ヨーロッパ標準時、韓国標準時、中央 オーストラリア標準時。

--name --resource-name -n

メンテナンス構成名。

--namespace

リソースの名前空間を取得または設定します。

--reboot-setting

パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。

承認された値: Always, IfRequired, Never

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--tags

リソースサポートの短縮構文、json-file、yaml-file のタグを取得または設定します。 詳細を表示するには、"??" を試してください。

--visibility

構成の可視性を取得または設定します。 既定値は 'Custom' です。

承認された値: Custom, Public

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。