Freigeben über


Set-AzVMSourceImage

Gibt das Image für einen virtuellen Computer an.

Syntax

ImageReferenceSkuParameterSet (Standard)

Set-AzVMSourceImage
    [-VM] <PSVirtualMachine>
    [-PublisherName] <String>
    [-Offer] <String>
    [-Skus] <String>
    [-Version] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ImageReferenceIdParameterSet

Set-AzVMSourceImage
    [-VM] <PSVirtualMachine>
    [-Id] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzVMSourceImage gibt das Plattformimage an, das für einen virtuellen Computer verwendet werden soll.

Beispiele

Beispiel 1: Festlegen von Werten für ein Bild

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
Set-AzVMSourceImage -VM $VirtualMachine -PublisherName "MicrosoftWindowsServer" -Offer "WindowsServer" -Skus "2012-R2-Datacenter" -Version "latest"

Der erste Befehl ruft den Verfügbarkeitssatz "AvailabilitySet03" in der Ressourcengruppe "ResourceGroup11" ab und speichert dieses Objekt dann in der $AvailabilitySet Variablen. Der zweite Befehl erstellt ein Objekt eines virtuellen Computers und speichert es dann in der $VirtualMachine Variablen. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Der virtuelle Computer gehört zu dem in $AvailabilitySet gespeicherten Verfügbarkeitssatz. Der letzte Befehl legt Werte für den Herausgebernamen, das Angebot, die SKU und die Version fest. Die Cmdlets "Get-AzVMImagePublisher", " Get-AzVMImageOffer", "Get-AzVMImageSku" und " Get-AzVMImage" können diese Einstellungen ermitteln.

Parameter

-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

-Id

Gibt die ID an.

Parametereigenschaften

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

Parametersätze

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

-Offer

Gibt den Typ des VMImage-Angebots an. Verwenden Sie das Cmdlet Get-AzVMImageOffer, um ein Bildangebot zu erhalten.

Parametereigenschaften

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

Parametersätze

ImageReferenceSkuParameterSet
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PublisherName

Gibt den Namen eines Herausgebers eines VMImage an. Verwenden Sie zum Abrufen eines Herausgebers das cmdlet Get-AzVMImagePublisher.

Parametereigenschaften

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

Parametersätze

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

-Skus

Gibt eine VMImage-SKU an. Verwenden Sie zum Abrufen von SKUs das cmdlet Get-AzVMImageSku.

Parametereigenschaften

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

Parametersätze

ImageReferenceSkuParameterSet
Position:3
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Version

Gibt eine Version eines VMImage an. Wenn Sie die neueste Version verwenden möchten, geben Sie anstelle einer bestimmten Version einen Wert der neuesten Version an.

Parametereigenschaften

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

Parametersätze

ImageReferenceSkuParameterSet
Position:4
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-VM

Gibt das zu konfigurierende objekt des lokalen virtuellen Computers an.

Parametereigenschaften

Typ:PSVirtualMachine
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:VMProfile

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:True
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

PSVirtualMachine

String

Ausgaben

PSVirtualMachine