Save-AzVMImage

  • Referenz
Modul:
Az.Compute

Speichert einen virtuellen Computer als VMImage.

Syntax

Save-AzVMImage
    [-Name] <String>
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [-Overwrite]
    [[-Path] <String>]
    [-ResourceGroupName] <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzVMImage
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [-Overwrite]
    [[-Path] <String>]
    [-Id] <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Save-AzVMImage speichert einen virtuellen Computer als VMImage. Bevor Sie ein Image eines virtuellen Computers erstellen, legen Sie den virtuellen Computer fest, und markieren Sie ihn dann mithilfe des Cmdlets Set-AzVM als generalisiert. Die Ausgabe dieses Cmdlets ist eine JSON-Vorlage (JavaScript Object Notation). Sie können virtuelle Computer aus Ihrem erfassten Image bereitstellen.

Beispiele

Beispiel 1: Erfassen eines virtuellen Computers

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized 
Save-AzVMImage -ResourceGroupName "ResourceGroup11" -VMName "VirtualMachine07" -DestinationContainerName "VMContainer01" -VHDNamePrefix "VM07"

Der erste Befehl kennzeichnet den virtuellen Computer "VirtualMachine07" als generalisiert. Der zweite Befehl erfasst einen virtuellen Computer namens VirtualMachine07 als VMImage. Die Output-Eigenschaft gibt eine JSON-Vorlage zurück.

Beispiel 2

Speichert einen virtuellen Computer als VMImage. (automatisch generiert)

Save-AzVMImage -DestinationContainerName 'VMContainer01' -Name 'VirtualMachine07' -Path '/home/admin/.ssh/authorized_keys' -ResourceGroupName 'ResourceGroup11' -VHDNamePrefix 'VM07'

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus, und geben Sie einen Auftrag zurück, um den Fortschritt nachzuverfolgen.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationContainerName

Gibt den Namen eines Containers innerhalb des "Systemcontainers" an, der Ihre Images enthalten soll. Falls der Container noch nicht vorhanden ist, wird er erstellt. Die virtuellen Festplatten (VHDs), die das VMImage bilden, befinden sich im Container, den dieser Parameter angibt. Wenn die VHDs auf mehrere Speicherkonten verteilt sind, erstellt dieses Cmdlet einen Container mit diesem Namen in jedem Speicherkonto. Die URL des gespeicherten Bilds ähnelt: https://< storageAccountName.blob.core.windows.net/system/Microsoft.Compute/Images/>< imagesContainer>/<vhdPrefix-osDisk.xxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx.vhd>.

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

-Id

Gibt die Ressourcen-ID des virtuellen Computers an.

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

-Name

Gibt einen Namen an

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

-Overwrite

Gibt an, dass dieses Cmdlet alle VHDs überschreibt, die dasselbe Präfix im Zielcontainer aufweisen.

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

-Path

Der Dateipfad, in dem die Vorlage des erfassten Bilds gespeichert wird.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-VHDNamePrefix

Gibt das Präfix im Namen der Blobs an, die das Speicherprofil des VMImage darstellen. Beispielsweise führt ein Präfix vhdPrefix für einen Betriebssystemdatenträger zum Namen vhdPrefix-osdisk.<guid.vhd>.

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

Eingaben

String

SwitchParameter

Ausgaben

PSComputeLongRunningOperation