Freigeben über

Add-AzureVMImage

  • Referenz
Modul:
Azure

Fügt dem Image-Repository ein neues Betriebssystemimage oder ein neues Image eines virtuellen Computers hinzu.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

Beschreibung

Das Add-AzureVMImage-Cmdlet fügt dem Image-Repository ein neues Betriebssystemimage oder ein neues Image eines virtuellen Computers hinzu. Das Image ist ein generalisiertes Betriebssystemimage, das entweder Sysprep für Windows oder für Linux verwendet, und verwendet das entsprechende Tool für die Verteilung.

Beispiele

Beispiel 1: Hinzufügen eines Betriebssystemimages zum Repository

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

In diesem Beispiel wird dem Repository ein Betriebssystemimage hinzugefügt.

Parameter

-Description

Gibt die Beschreibung des Betriebssystemimages an.

Typ:String
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DiskConfig

Gibt die Betriebssystemdatenträgerkonfiguration für das Image des virtuellen Computers an.

Typ:VirtualMachineImageDiskConfigSet
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Eula

Gibt den Endbenutzer-Lizenzvertrag an. Es wird empfohlen, eine URL für diesen Wert zu verwenden.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IconName

Gibt den Namen des Symbols an, das verwendet wird, wenn das Bild dem Repository hinzugefügt wird.

Typ:String
Aliase:IconUri
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ImageFamily

Gibt einen Wert an, der zum Gruppieren von Betriebssystemimages verwendet wird.

Typ:String
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ImageName

Gibt den Namen des Bilds an, das dem Image-Repository hinzugefügt wird.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Label

Gibt eine Beschriftung an, die dem Bild zugewiesen werden soll.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MediaLocation

Gibt den Speicherort der physischen BLOB-Seite an, auf der sich das Bild befindet. Dies ist ein Link zu einer BLOB-Seite im Speicher des aktuellen Abonnements.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OS

Gibt die Betriebssystemversion des Images an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PrivacyUri

Gibt die URL an, die auf ein Dokument verweist, das die Datenschutzrichtlinie im Zusammenhang mit dem Betriebssystemimage enthält.

Typ:Uri
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublishedDate

Gibt das Datum an, an dem das Betriebssystemimage dem Image-Repository hinzugefügt wurde.

Typ:DateTime
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RecommendedVMSize

Gibt die Größe an, die für den virtuellen Computer verwendet werden soll, der aus dem Betriebssystemimage erstellt wird.

Zulässige Werte für diesen Parameter:

  • Medium
  • Groß
  • Extragroß
  • A5
  • A6
  • A7
Typ:String
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ShowInGui

Gibt an, dass dieses Cmdlet das Bild in der GUI anzeigt.

Typ:SwitchParameter
Position:12
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SmallIconName

Gibt den Namen des kleinen Symbols an, das verwendet wird, wenn das Bild dem Repository hinzugefügt wird.

Typ:String
Aliase:SmallIconUri
Position:11
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

OSImageContext