Test-ContainerImage

[アーティクル]
11/16/2015

Test-ContainerImage

Tests for problems with a container image.

構文

Parameter Set: Container Image Object
Test-ContainerImage [-Image] <ContainerImage> [-AsJob] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Name
Test-ContainerImage [[-Name] <String> ] [[-Publisher] <String> ] [[-Version] <Version> ] [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Test-ContainerImage cmdlet tests for problems with a container image.

パラメーター

-AsJob

Indicates that this cmdlet runs the command as a background job on a remote computer. Use this parameter to run commands that take an extensive time to complete.

When you use AsJob, the command returns an object that represents the job, and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the Job cmdlets. To get the job results, use the Receive-Job cmdlet.

For more information about Windows PowerShell background jobs, see about_Jobs (https://go.microsoft.com/fwlink/?LinkID=113251) and about_Remote_Jobs (https://go.microsoft.com/fwlink/?LinkID=135184).

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-CimSession<CimSession[]>

リモートセッションまたはリモートコンピューターでコマンドレットを実行します。コンピューター名またはセッションオブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカルコンピューター上の現在のセッションです。

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts to run the cmdlet. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer. Use "localhost" or a dot (".") to specify the local computer explicitly.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Credential<PSCredential[]>

Specifies a user account that has permission to perform this action. The default is the current user.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Image<ContainerImage>

Specifies the container image to test.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true(ByValue)
ワイルドカード文字の受け入れ	false

-Name<String>

Specifies the name of the container image to test.

Aliases	none
必須/オプション	false
位置	1
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Publisher<String>

Specifies the publisher of the container image to test.

Aliases	none
必須/オプション	false
位置	2
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Version<Version>

Specifies the version of the container image to test.

Aliases	none
必須/オプション	false
位置	3
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション	false
位置	named
既定値	false
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

Microsoft.Containers.PowerShell.Objects.ContainerImageReport

Microsoft.Containers.PowerShell.Objects.ContainerImageReport

使用例

Example 1: Test a container image

This command tests for problems with the image stored in the $Image01 variable.

PS C:\> Test-ContainerImage -Image $Image01

Test-ContainerImage