Save-AzureRmVMImage
Speichert einen virtuellen Computer als VMImage.
Warnung
Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.
Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
Save-AzureRmVMImage
[-Name] <String>
[-DestinationContainerName] <String>
[-VHDNamePrefix] <String>
[-Overwrite]
[[-Path] <String>]
[-ResourceGroupName] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Save-AzureRmVMImage
[-Name] <String>
[-DestinationContainerName] <String>
[-VHDNamePrefix] <String>
[-Overwrite]
[[-Path] <String>]
[-Id] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Beschreibung
Das Cmdlet Save-AzureRmVMImage 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-AzureRmVM 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
PS C:\> Set-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized
PS C:\> Save-AzureRmVMImage -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.
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: | 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 |