通过

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

Add-AzureVMImage

模块:
Azure Module

将新的作系统映像或新的虚拟机映像添加到映像存储库。

注释

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

OSImage （默认值） 

Add-AzureVMImage
    [-ImageName] <String>
    [-MediaLocation] <String>
    [-OS] <String>
    [[-Label] <String>]
    [[-Eula] <String>]
    [[-Description] <String>]
    [[-ImageFamily] <String>]
    [[-PublishedDate] <DateTime>]
    [[-PrivacyUri] <Uri>]
    [[-RecommendedVMSize] <String>]
    [[-IconName] <String>]
    [[-SmallIconName] <String>]
    [-ShowInGui]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

VMImage 

Add-AzureVMImage
    [-ImageName] <String>
    [-DiskConfig] <VirtualMachineImageDiskConfigSet>
    [[-OS] <String>]
    [[-Label] <String>]
    [[-Eula] <String>]
    [[-Description] <String>]
    [[-ImageFamily] <String>]
    [[-PublishedDate] <DateTime>]
    [[-PrivacyUri] <Uri>]
    [[-RecommendedVMSize] <String>]
    [[-IconName] <String>]
    [[-SmallIconName] <String>]
    [-ShowInGui]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

说明

Add-AzureVMImage cmdlet 向映像存储库添加新的作系统映像或新的虚拟机映像。 该映像是一个通用作系统映像，使用适用于 Windows 的 Sysprep，或者对于 Linux，使用适用于分发的相应工具。

示例

示例 1：将作系统映像添加到存储库

PS C:\> $S = New-AzureVMImageDiskConfigSet
PS C:\> Set-AzureVMImageOSDiskConfig -DiskConfig $S -HostCaching ReadWrite -OSState "Generalized" -OS "Windows" -MediaLink $Link
PS C:\> Set-AzureVMImageDataDiskConfig -DiskConfig $S -DataDiskName "Test1" -HostCaching ReadWrite -Lun 0 -MediaLink $Link1
PS C:\> Set-AzureVMImageDataDiskConfig -DiskConfig $S -DataDiskName "Test4" -HostCaching ReadWrite -Lun 0 -MediaLink $Link
PS C:\> Remove-AzureVMImageDataDiskConfig -DiskConfig $S -DataDiskName "Test4"
PS C:\> $IMGName = "TestCREATEvmimage2";
PS C:\> Add-AzureVMImage -ImageName $IMGName -Label "Test1" -Description "Test1" -DiskConfig $S -Eula "http://www.contoso.com" -ImageFamily Windows -PublishedDate (Get-Date) -PrivacyUri "http://www.test.com" -RecommendedVMSize Small -IconName "Icon01" -SmallIconName "SmallIcon01" -ShowInGui

此示例将作系统映像添加到存储库。

参数

-Description

指定作系统映像的说明。

参数属性

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

参数集

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

-DiskConfig

指定虚拟机映像的作系统磁盘配置。

参数属性

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

参数集

VMImage
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Eula

指定最终用户许可协议。 建议对此值使用 URL。

参数属性

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

参数集

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

-IconName

指定将映像添加到存储库时使用的图标的名称。

参数属性

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

参数集

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

-ImageFamily

指定用于对作系统映像进行分组的值。

参数属性

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

参数集

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

-ImageName

指定要添加到映像存储库中的映像的名称。

参数属性

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

参数集

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

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

  • 继续
  • 忽略
  • 查询
  • 静默继续
  • 停下
  • 暂停

参数属性

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

参数集

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

-InformationVariable

指定信息变量。

参数属性

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

参数集

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

-Label

指定要为图像提供标签。

参数属性

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

参数集

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

-MediaLocation

指定映像所在的物理 Blob 页的位置。 这是指向当前订阅存储中的 Blob 页的链接。

参数属性

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

参数集

OSImage
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-OS

指定映像的作系统版本。

参数属性

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

参数集

OSImage
Position:2
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-PrivacyUri

指定指向包含与作系统映像相关的隐私策略的文档的 URL。

参数属性

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

参数集

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

参数属性

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

参数集

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

-PublishedDate

指定将作系统映像添加到映像存储库的日期。

参数属性

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

参数集

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

-RecommendedVMSize

指定要用于从作系统映像创建的虚拟机的大小。

此参数的可接受值为：

  • 中等
  • 大
  • 超大型
  • A5
  • A6
  • A7

参数属性

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

参数集

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

-ShowInGui

指示此 cmdlet 在 GUI 中显示图像。

参数属性

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

参数集

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

-SmallIconName

指定将映像添加到存储库时使用的小型图标的名称。

参数属性

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

参数集

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

CommonParameters

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

输出

OSImageContext