共用方式為

Add-AzureVMImage

  • 參考
模組:
Azure

將新的作業系統映像或新的虛擬機映像新增至映像存放庫。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

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>]
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>]

Description

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
Position:5
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DiskConfig

指定虛擬機映像的作業系統磁碟組態。

類型:VirtualMachineImageDiskConfigSet
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Eula

指定使用者許可協定。 建議您針對此值使用 URL。

類型:String
Position:4
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-IconName

指定將映像新增至存放庫時所使用的圖示名稱。

類型:String
別名:IconUri
Position:10
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ImageFamily

指定用來將操作系統映像分組的值。

類型:String
Position:6
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ImageName

指定要新增至映像存放庫的映像名稱。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

類型:String
別名:iv
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Label

指定要提供影像的標籤。

類型:String
Position:3
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-MediaLocation

指定映像所在的實體 Blob 頁面位置。 這是目前訂用帳戶記憶體中 Blob 頁面的連結。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-OS

指定映像的作業系統版本。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PrivacyUri

指定指向包含作業系統映像相關隱私策略的檔URL。

類型:Uri
Position:8
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PublishedDate

指定作業系統映像新增至映像存放庫的日期。

類型:DateTime
Position:7
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-RecommendedVMSize

指定要用於從作業系統映像建立之虛擬機的大小。

此參數可接受的值為：

  • 中
  • 大型
  • 特大型
  • A5
  • A6
  • A7
類型:String
Position:9
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ShowInGui

指出此 Cmdlet 會在 GUI 中顯示影像。

類型:SwitchParameter
Position:12
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-SmallIconName

指定將映像新增至存放庫時所使用的小型圖示名稱。

類型:String
別名:SmallIconUri
Position:11
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸出

OSImageContext