Freigeben über


Save-AzVMImage

Speichert einen virtuellen Computer als VMImage.

Syntax

ResourceGroupNameParameterSetName (Standard)

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

IdParameterSetName

Save-AzVMImage
    [-DestinationContainerName] <String>
    [-VHDNamePrefix] <String>
    [[-Path] <String>]
    [-Id] <String>
    [-Overwrite]
    [-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 vor, 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. (autogenerated)

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DestinationContainerName

Gibt den Namen eines Containers innerhalb des "Systemcontainers" an, der Ihre Images enthalten soll. Wenn der Container nicht vorhanden ist, wird er für Sie 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>.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Id

Gibt die Ressourcen-ID des virtuellen Computers an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

IdParameterSetName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Gibt einen Namen an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:VMName

Parametersätze

ResourceGroupNameParameterSetName
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Overwrite

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Path

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:5
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ResourceGroupNameParameterSetName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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>.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:VirtualHardDiskNamePrefix

Parametersätze

(All)
Position:3
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

SwitchParameter

Ausgaben

PSComputeLongRunningOperation