翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# test
<a name="cfn-guard-test"></a>

 AWS CloudFormation Guard ルールファイルを JSON または YAML 形式の Guard ユニットテストファイルと照合して検証し、個々のルールの成功を判断します。

## 構文
<a name="cfn-guard-test-synopsis"></a>

```
cfn-guard test 
--rules-file <value>
--test-data <value>
```

## パラメータ
<a name="cfn-guard-test-flags"></a>

`-a`, `--alphabetical`

ディレクトリ内でアルファベット順にソートします。

`-h`, `--help`

ヘルプ情報を表示します。

`-m`, `--last-modified`

ディレクトリ内の最終変更時刻でソートします。

`-V`, `--version`

バージョン情報を表示します。

`-v`, `--verbose`

出力の詳細度を高めます。複数回指定できます。

詳細な出力は、Guard ルールファイルの構造に従います。ルールファイル内のすべてのブロックは、詳細出力のブロックです。一番上のブロックは各ルールです。ルールに対して`when`条件がある場合、それらは兄弟条件ブロックとして表示されます。

## オプション
<a name="cfn-guard-test-options"></a>

`-d`, `--dir`

ルールのルートディレクトリを指定します。

`-o`, `--output-format`

出力を表示する形式を指定します。

*デフォルト*: `single-line-summary`

使用できる値: `json` \$1 `yaml` \$1 `single-line-summary` \$1 `junit`

`-r`, `--rules-file`

ルールファイルの名前を指定します。

`-t`, `--test-data`

JSON 形式または YAML 形式のデータファイルの名前またはディレクトリを指定します。

## 例
<a name="cfn-guard-test-examples"></a>

```
cfn-guard test --rules-file rules.guard --test-data example.json
```

## Output
<a name="cfn-guard-test-output"></a>

```
PASS|FAIL Expected Rule = rule_name, Status = SKIP|FAIL|PASS, Got Status = SKIP|FAIL|PASS
```

## 関連情報
<a name="cfn-guard-test-see-also"></a>

[ガードルールのテスト](testing-rules.md)