New-ContainerImage
New-ContainerImage
Creates a container image from an existing container.
構文
Parameter Set: Container Id
New-ContainerImage [-ContainerId] <Guid> [-Name] <String> [-Publisher] <String> [-Version] <Version> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Container Name
New-ContainerImage [-ContainerName] <String> [-Name] <String> [-Publisher] <String> [-Version] <Version> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Container Object
New-ContainerImage [-Container] <Container> [-Name] <String> [-Publisher] <String> [-Version] <Version> [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The New-ContainerImage cmdlet creates a container image from an existing container.
パラメーター
-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 |
-Container<Container>
Specifies the container from which to create the image.
Aliases |
none |
必須/オプション |
true |
位置 |
1 |
既定値 |
none |
パイプライン入力の受け入れ |
true(ByValue) |
ワイルドカード文字の受け入れ |
false |
-ContainerId<Guid>
Specifies the ID of the container from which to create the image.
Aliases |
none |
必須/オプション |
true |
位置 |
1 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-ContainerName<String>
Specifies the name of the container from which to create the image.
Aliases |
none |
必須/オプション |
true |
位置 |
1 |
既定値 |
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 |
-Name<String>
Specifies the name of the container image that this cmdlet creates.
Aliases |
none |
必須/オプション |
true |
位置 |
2 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-Publisher<String>
Specifies the publisher of the container image that this cmdlet creates.
Aliases |
none |
必須/オプション |
true |
位置 |
3 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-Version<Version>
Specifies the version of the container image that this cmdlet creates.
Aliases |
none |
必須/オプション |
true |
位置 |
4 |
既定値 |
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.ContainerImage
Microsoft.Containers.PowerShell.Objects.ContainerImage
使用例
Create a container image from an existing container
This command creates a new container image from the container in the $Container01 variable, and specifies the name, publisher, and version of the new image.
PS C:\> New-ContainerImage -Container $Container01 -Name "Image01" -Publisher Contoso -Version 1.1.0.0