你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Save-AzVMImage

将虚拟机另存为 VMImage。

语法

ResourceGroupNameParameterSetName (默认值)

Save-AzVMImage
    [-Name] <String>
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [[-Path] <String>]
    [-ResourceGroupName] <String>
    [-Overwrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

IdParameterSetName

Save-AzVMImage
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [[-Path] <String>]
    [-Id] <String>
    [-Overwrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

Save-AzVMImage cmdlet 将虚拟机另存为 VMImage。 在创建虚拟机映像之前,sysprep 虚拟机,然后使用 Set-AzVM cmdlet 将其标记为通用化。 此 cmdlet 的输出是 JavaScript 对象表示法 (JSON) 模板。 可以从捕获的映像部署虚拟机。

示例

示例 1:捕获虚拟机

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized
Save-AzVMImage -ResourceGroupName "ResourceGroup11" -VMName "VirtualMachine07" -DestinationContainerName "VMContainer01" -VHDNamePrefix "VM07"

第一个命令将名为 VirtualMachine07 的虚拟机标记为通用化。 第二个命令将名为 VirtualMachine07 的虚拟机捕获为 VMImage。 Output 属性返回 JSON 模板。

示例 2

将虚拟机另存为 VMImage。 (autogenerated)

Save-AzVMImage -DestinationContainerName 'VMContainer01' -Name 'VirtualMachine07' -Path '/home/admin/.ssh/authorized_keys' -ResourceGroupName 'ResourceGroup11' -VHDNamePrefix 'VM07'

参数

-AsJob

在后台运行 cmdlet 并返回作业以跟踪进度。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DestinationContainerName

指定要保存映像的“系统”容器中的容器的名称。 如果容器不存在,则会为你创建它。 构成 VMImage 的虚拟硬盘(VHD)驻留在此参数指定的容器中。 如果 VHD 分布在多个存储帐户中,则此 cmdlet 会在每个存储帐户中创建一个具有此名称的容器。 保存图像的 URL 类似于:https://< storageAccountName.blob.core.windows.net/system/Microsoft.Compute/Images/>< imagesContainer>/<vhdPrefix-osDisk.xxxxxxxx-xxxx-xxxx-xxxx-xxx.vhd>。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Id

指定虚拟机的资源 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

IdParameterSetName
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

指定名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:虚拟机名称

参数集

ResourceGroupNameParameterSetName
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Overwrite

指示此 cmdlet 覆盖目标容器中具有相同前缀的任何 VHD。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:4
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Path

在其中存储捕获映像模板的文件路径。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:5
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceGroupName

指定虚拟机资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceGroupNameParameterSetName
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-VHDNamePrefix

指定构成 VMImage 存储配置文件的 blob 名称中的前缀。 例如,作系统磁盘的前缀 vhdPrefix 会导致名称 vhdPrefix-osdisk。<guid.vhd>。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:VirtualHardDiskNamePrefix

参数集

(All)
Position:3
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

SwitchParameter

输出

PSComputeLongRunningOperation