Share via


Add-AzureVMImage

新しいオペレーティング システム イメージまたは新しい仮想マシン イメージをイメージ リポジトリに追加します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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>]

説明

Add-AzureVMImage コマンドレットは、新しいオペレーティング システム イメージまたは新しい仮想マシン イメージをイメージ リポジトリに追加します。 イメージは一般化されたオペレーティング システム イメージであり、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

このコマンドレットが情報イベントに応答する方法を指定します。

このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
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

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

オペレーティング システム イメージから作成される仮想マシンに使用するサイズを指定します。

このパラメーターの有効値は、次のとおりです。

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

-ShowInGui

このコマンドレットが 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