Save-ContainerImage

NAME Save-ContainerImage



SYNOPSIS

Saves a container image without installing it.





SYNTAX

Save-ContainerImage [-Name] <String[]> [-MinimumVersion <Version>] [-MaximumVersion <Version>] [-RequiredVersion

<Version>] -Path <String> [-Force] [-source <String>] [-WhatIf] [-Confirm] [<CommonParameters>]



Save-ContainerImage [-Name] <String[]> [-MinimumVersion <Version>] [-MaximumVersion <Version>] [-RequiredVersion

<Version>] -LiteralPath <String> [-Force] [-source <String>] [-WhatIf] [-Confirm] [<CommonParameters>]



Save-ContainerImage -InputObject <PSObject[]> -LiteralPath <String> [-Force] [-source <String>] [-WhatIf]

[-Confirm] [<CommonParameters>]



Save-ContainerImage -InputObject <PSObject[]> -Path <String> [-Force] [-source <String>] [-WhatIf] [-Confirm]

[<CommonParameters>]





DESCRIPTION

The Save-ContainerImage cmdlet lets you save a container image locally without installing it.

This lets you inspect the container image before you install, helping to minimize the risks

of malicious code or malware on your system.

As a best practice, when you have finished evaluating a container image for potential risks,

and before you install the image for use, delete the image from the path to which you have saved.





PARAMETERS

-Name <String[]>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-InputObject <PSObject[]>



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-MinimumVersion <Version>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-MaximumVersion <Version>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-RequiredVersion <Version>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Path <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-LiteralPath <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Force [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-source <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Save-ContainerImage -Name ImageName -Path C:\\temp\\













-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Save-ContainerImage -Name ImageName -LiteralPath C:\\temp\\













-------------------------- EXAMPLE 3 --------------------------



PS C:\\>Save-ContainerImage -Name ImageName -MinimumVersion Version -Path .\\..\\













-------------------------- EXAMPLE 4 --------------------------



PS C:\\>Save-ContainerImage -Name ImageName -MaximumVersion Version -LiteralPath C:\\temp\\













-------------------------- EXAMPLE 5 --------------------------



PS C:\\>Save-ContainerImage -Name ImageName -RequiredVersion Version -Path C:\\t*p\\













-------------------------- EXAMPLE 6 --------------------------



PS C:\\>Save-ContainerImage -Name ImageName -RequiredVersion Version -Path C:\\t*p\\ -Source ContainerImageGallery













-------------------------- EXAMPLE 7 --------------------------



PS C:\\>Find-ContainerImage -Name ImageName | Save-ContainerImage -LiteralPath C:\\temp\\















RELATED LINKS