Freigeben über


Set-AzVmssStorageProfile

Legt die Speicherprofileigenschaften für vmSS fest.

Syntax

Set-AzVmssStorageProfile
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-ImageReferencePublisher] <String>]
   [[-ImageReferenceOffer] <String>]
   [[-ImageReferenceSku] <String>]
   [[-ImageReferenceVersion] <String>]
   [[-OsDiskName] <String>]
   [[-OsDiskCaching] <CachingTypes>]
   [[-OsDiskCreateOption] <String>]
   [-OsDiskDeleteOption <String>]
   [[-OsDiskOsType] <OperatingSystemTypes>]
   [[-Image] <String>]
   [[-VhdContainer] <String[]>]
   [-ImageReferenceId <String>]
   [-OsDiskWriteAccelerator]
   [-DiffDiskSetting <String>]
   [-DiffDiskPlacement <String>]
   [-ManagedDisk <String>]
   [-DiskEncryptionSetId <String>]
   [-DataDisk <VirtualMachineScaleSetDataDisk[]>]
   [-OSDiskSizeGB <Int32>]
   [-DiskControllerType <String>]
   [-SecurityEncryptionType <String>]
   [-SecureVMDiskEncryptionSet <String>]
   [-SharedGalleryImageId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzVmssStorageProfile legt die Speicherprofileigenschaften für den Vm Scale Set (VMSS) fest.

Beispiele

Beispiel 1: Festlegen der Speicherprofileigenschaften für vmSS

Set-AzVmssStorageProfile -VirtualMachineScaleSet "ContosoVMSS" -Name "Test" -OsDiskCreateOption "FromImage" -OsDiskCaching "None" `
            -ImageReferenceOffer $ImgRef.Offer -ImageReferenceSku $ImgRef.Skus -ImageReferenceVersion $ImgRef.Version `
            -ImageReferencePublisher $ImgRef.PublisherName -VhdContainer $VhdContainer

Mit diesem Befehl werden die Speicherprofileigenschaften für die VMSS namens ContosoVMSS festgelegt.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DataDisk

Gibt das Datenträgerobjekt an.

Typ:VirtualMachineScaleSetDataDisk[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-DiffDiskPlacement

Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, d. h. zwischenspeichern des Datenträgers oder des Ressourcenspeichers für die Bereitstellung des ephemeralen Betriebssystemdatenträgers. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter Ephemeral Os Disk Size Requirements for Windows VM at and Linux VM at https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Dieser Parameter kann nur verwendet werden, wenn der Parameter DiffDiskSetting auf "Local" festgelegt ist.

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

-DiffDiskSetting

Gibt die unterschiedlichen Datenträgereinstellungen für den Betriebssystemdatenträger an.

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

-DiskControllerType

Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer und VirtualMachineScaleSet konfiguriert ist. Diese Eigenschaft wird nur für virtuelle Computer unterstützt, deren Betriebssystemdatenträger und VM-Sku die Generation 2 unterstützt (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), überprüfen Sie die HyperVGenerations-Funktion, die als Teil der VM-Sku-Funktionen in der Antwort der Microsoft.Compute SKUs-API für die Region V2 (https://learn.microsoft.com/rest/api/compute/resourceskus/list) zurückgegeben wird.
Weitere Informationen zu unterstützten Datenträgercontrollertypen finden Sie unter https://aka.ms/azure-diskcontrollertypes.

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

-DiskEncryptionSetId

Gibt die Ressourcen-ID des vom Kunden verwalteten Datenträgerverschlüsselungssatzes an. Dies kann nur für verwaltete Datenträger angegeben werden.

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

-Image

Gibt den BLOB-URI für das Benutzerbild an. VMSS erstellt einen Betriebssystemdatenträger im selben Container des Benutzerimages.

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

-ImageReferenceId

Gibt die Bildverweis-ID an.

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

-ImageReferenceOffer

Gibt den Typ des VMImage-Angebots (Virtual Machine Image) an. Verwenden Sie zum Abrufen eines Bildangebots das Cmdlet Get-AzVMImageOffer.

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

-ImageReferencePublisher

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

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

-ImageReferenceSku

Gibt die VMImage-SKU an. Verwenden Sie zum Abrufen von SKUs das Cmdlet Get-AzVMImageSku.

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

-ImageReferenceVersion

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

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

-ManagedDisk

Gibt den verwalteten Datenträger an.

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

-OsDiskCaching

Gibt den Cachemodus des Betriebssystemdatenträgers an. Zulässige Werte für diesen Parameter:

  • ReadOnly
  • ReadWrite Der Standardwert ist ReadWrite. Wenn Sie den Cachewert ändern, startet das Cmdlet den virtuellen Computer neu. Diese Einstellung wirkt sich auf die Konsistenz und Leistung des Datenträgers aus.
Typ:Nullable<T>[CachingTypes]
Zulässige Werte:None, ReadOnly, ReadWrite
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OsDiskCreateOption

Gibt an, wie dieses Cmdlet die virtuellen VMSS-Computer erstellt. Zulässige Werte für diesen Parameter:

  • Anfügen: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger verwenden, um den virtuellen VMSS-Computer zu erstellen.
  • FromImage: Dieser Wert wird verwendet, wenn Sie ein Image verwenden, um den virtuellen VMSS-Computer zu erstellen. Wenn Sie ein Plattformimage verwenden, verwenden Sie auch den imageReference-Parameter .
Typ:String
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OsDiskDeleteOption

Gibt an, ob der Betriebssystemdatenträger beim Löschen von VMSS Flex gelöscht oder getrennt werden soll (Dieses Feature ist nur für VMSS mit Flexible OrchestrationMode verfügbar).

Akzeptierte Werte löschen – Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger gelöscht, wenn der VMSS Flex VM gelöscht wird. Trennen – Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger beibehalten, nachdem vmSS Flex VM gelöscht wurde.

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

-OsDiskName

Gibt den Namen des Betriebssystemdatenträgers an.

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

-OsDiskOsType

Gibt den Typ des Betriebssystems auf dem Datenträger an. Dies ist nur für Benutzerimageszenarien und nicht für ein Plattformimage erforderlich.

Typ:Nullable<T>[OperatingSystemTypes]
Zulässige Werte:Windows, Linux
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OSDiskSizeGB

Gibt die Größe eines leeren Datenträgers in Gigabyte an. Dieses Element kann verwendet werden, um die Größe des Datenträgers in einem Image eines virtuellen Computers zu überschreiben.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OsDiskWriteAccelerator

Gibt an, ob WriteAccelerator auf dem Betriebssystemdatenträger aktiviert oder deaktiviert werden soll.

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

-SecureVMDiskEncryptionSet

ResourceId des Datenträgerverschlüsselungssatzes, der zum Aktivieren der ruhenden Verschlüsselung verwendet werden soll.

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

-SecurityEncryptionType

Legt den SecurityEncryptionType des Skalierungssatzes des virtuellen Computers fest. Mögliche Werte sind: DiskWithVMGuestState, VMGuestStateOnly

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

-SharedGalleryImageId

Gibt die eindeutige ID des freigegebenen Katalogimages für die Vm-Bereitstellung an. Dies kann aus dem GET-Aufruf des freigegebenen Katalogbilds abgerufen werden.

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

-VhdContainer

Gibt die Container-URLs an, die zum Speichern von Betriebssystemdatenträgern für vmSS verwendet werden.

Typ:String[]
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VirtualMachineScaleSet

Gibt das VMSS-Objekt an. Verwenden Sie zum Abrufen des Objekts das New-AzVmssConfig-Objekt.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

PSVirtualMachineScaleSet

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

String[]

VirtualMachineScaleSetDataDisk[]

Ausgaben

PSVirtualMachineScaleSet