共用方式為

Add-AzureVMImage

  • 參考
模組:
Azure

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

注意

本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。

Syntax

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

指定作業系統映射的描述。

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskConfig

指定虛擬機器映射的作業系統磁片組態。

Type:VirtualMachineImageDiskConfigSet
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Eula

指定使用者授權合約。 建議您針對此值使用 URL。

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IconName

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

Type:String
Aliases:IconUri
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageFamily

指定用來將作業系統映射分組的值。

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

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

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定資訊變數。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Label

指定要提供影像的標籤。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MediaLocation

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OS

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PrivacyUri

指定指向包含作業系統映射相關隱私權原則的檔 URL。

Type:Uri
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishedDate

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

Type:DateTime
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RecommendedVMSize

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

此參數可接受的值為：

  • 中
  • 大型
  • ExtraLarge
  • A5
  • A6
  • A7
Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShowInGui

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

Type:SwitchParameter
Position:12
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SmallIconName

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

Type:String
Aliases:SmallIconUri
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

輸出

OSImageContext