az maintenance configuration

注

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

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

コマンド

名前	説明	型	状態
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-name
                                    --resource-group
                                    [--duration --maintenance-window-duration]
                                    [--expiration-date-time --maintenance-window-expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters --linux-parameters]
                                    [--install-patches-windows-parameters --windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every --recur-every]
                                    [--maintenance-window-start-date-time --start-date-time]
                                    [--maintenance-window-time-zone --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

maintenanceConfiguration 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

構成の maintenanceScope を取得または設定します。

指定可能な値: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance

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

メンテナンス期間が繰り返されると予想されるレート。 料金は、毎日、毎週、または毎月のスケジュールとして表すことができます。 1 日のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 毎日のスケジュールの例は recurEvery: Day、recurEvery: 3Days です。 週単位のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays monday-sunday]\ (週単位のスケジュールは、整数としての頻度]['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、W. ヨーロッパ標準時、韓国標準時、Cen。 オーストラリア標準時。

--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-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-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 --maintenance-window-duration]
                                    [--expiration-date-time --maintenance-window-expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters --linux-parameters]
                                    [--install-patches-windows-parameters --windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every --recur-every]
                                    [--maintenance-window-start-date-time --start-date-time]
                                    [--maintenance-window-time-zone --time-zone]
                                    [--name --resource-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

maintenanceConfiguration 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

構成の maintenanceScope を取得または設定します。

指定可能な値: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance

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

メンテナンス期間が繰り返されると予想されるレート。 料金は、毎日、毎週、または毎月のスケジュールとして表すことができます。 1 日のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 毎日のスケジュールの例は recurEvery: Day、recurEvery: 3Days です。 週単位のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays monday-sunday]\ (週単位のスケジュールは、整数としての頻度]['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、W. ヨーロッパ標準時、韓国標準時、Cen。 オーストラリア標準時。

--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 を使用します。