az policy attestation

リソースポリシー構成証明を管理します。

コマンド

名前	説明	型	状態
az policy attestation create	ポリシー構成証明を作成します。	Core	GA
az policy attestation delete	既存のポリシー構成証明を削除します。	Core	GA
az policy attestation list	リソースのすべての構成証明を一覧表示します。	Core	GA
az policy attestation show	ポリシー構成証明を取得します。	Core	GA
az policy attestation update	既存のポリシー構成証明を更新します。	Core	GA

az policy attestation create

編集

ポリシー構成証明を作成します。

az policy attestation create --attestation-name --name
                             --policy-assignment --policy-assignment-id
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

例

ポリシー割り当てのリソースグループスコープで構成証明を作成する

az policy attestation create -g myRg -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

ポリシー割り当てリソース ID を使用して、ポリシー割り当てのリソースグループスコープで構成証明を作成する

az policy attestation create -g myRg -n myAttestation \
  --policy-assignment "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa"

ポリシーセットの割り当てのサブスクリプションスコープで構成証明を作成する

az policy attestation create -n myAttestation \
  --policy-assignment eeb18edc813c42d0ad5a9eab \
  --definition-reference-id auditVMPolicyReference

リソース ID を使用して特定のリソースの構成証明を作成する

az policy attestation create \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

すべてのプロパティを使用してリソースグループスコープで構成証明を作成する

az policy attestation create --attestation-name myAttestation -g myRg -a eeb18edc813c42d0ad5a9eab \
 --compliance-state Compliant --assessment-date 2023-01-01T08:29:18Z \
 --evidence source-uri=https://sampleuri.com description="Sample description for the sample uri" \
 --evidence source-uri=https://sampleuri2.com description="Sample description 2 for the sample uri 2" \
 --expires-on 2024-08-01T05:29:18Z --owner user@myOrg.com --metadata Location=NYC Dept=ACC \
 --definition-reference-id auditVMPolicyReference

必須のパラメーター

--attestation-name --name -n

構成証明の名前。

--policy-assignment --policy-assignment-id -a

構成証明によって状態が設定されているポリシー割り当てのリソース ID。

プロパティ	値
パラメーターグループ:	Properties Arguments

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--assessment-date

証拠が評価された時刻。

プロパティ	値
パラメーターグループ:	Properties Arguments

--comments

この構成証明が作成された理由を説明するコメント。

プロパティ	値
パラメーターグループ:	Properties Arguments

--compliance-state

リソースに設定する必要があるコンプライアンス状態。

プロパティ	値
パラメーターグループ:	Properties Arguments
指定可能な値:	Compliant, NonCompliant, Unknown

--definition-reference-id

構成証明によって状態が設定されているポリシーセット定義のポリシー定義参照 ID。ポリシー割り当てでポリシーセット定義が割り当てられている場合、構成証明は、このプロパティを使用してセット定義内の定義を選択するか、これを省略してセット定義全体の状態を設定できます。

プロパティ	値
パラメーターグループ:	Properties Arguments

--evidence

この構成証明で設定されたコンプライアンス状態をサポートする証拠。

プロパティ	値
パラメーターグループ:	Properties Arguments

--expires-on

コンプライアンス状態の有効期限が切れる時刻。

プロパティ	値
パラメーターグループ:	Properties Arguments

--metadata

構成証明のスペース区切りキーと値のペア内の追加のメタデータ。これにより、構成証明の既存のメタデータが上書きされます。

プロパティ	値
パラメーターグループ:	Properties Arguments

--namespace

プロバイダー名前空間 (例: Microsoft.Provider)。

プロパティ	値
パラメーターグループ:	Resource ID Arguments

--owner

リソースの状態を設定する責任者。通常、この値は Azure Active Directory オブジェクト ID です。

プロパティ	値
パラメーターグループ:	Properties Arguments

--parent

親パス (例: resourceTypeA/nameA/resourceTypeB/nameB)。

プロパティ	値
パラメーターグループ:	Resource ID Arguments

--resource --resource-id

リソース ID またはリソース名。名前が指定されている場合は、リソースグループとその他の関連するリソース ID 引数を指定してください。

プロパティ	値
パラメーターグループ:	Resource ID Arguments

--resource-group -g

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

プロパティ	値
パラメーターグループ:	Scope Arguments

--resource-type

リソースの種類 (例: resourceTypeC)。

プロパティ	値
パラメーターグループ:	Resource ID Arguments

グローバルパラメーター

--debug

ログの詳細度を上げて、すべてのデバッグログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

出力フォーマット。

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。完全なデバッグログには --debug を使用します。

プロパティ	値
規定値:	False