Freigeben über


New-AzDiskUpdateConfig

Erstellt ein konfigurierbares Datenträgeraktualisierungsobjekt.

Syntax

New-AzDiskUpdateConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-NetworkAccessPolicy <String>]
   [-DiskAccessId <String>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Tag] <Hashtable>]
   [-DiskIOPSReadWrite <Int32>]
   [-DiskMBpsReadWrite <Int32>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzDiskUpdateConfig erstellt ein konfigurierbares Datenträgeraktualisierungsobjekt.

Beispiele

Beispiel 1

$diskupdateconfig = New-AzDiskUpdateConfig -DiskSizeGB 10 -SkuName Premium_LRS -OsType Windows -EncryptionSettingsEnabled $true;
$secretUrl = 'https://myvault.vault-int.azure-int.net/secrets/123/';
$secretId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault123';
$keyUrl = 'https://myvault.vault-int.azure-int.net/keys/456';
$keyId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault456';
$diskupdateconfig = Set-AzDiskUpdateDiskEncryptionKey -DiskUpdate $diskupdateconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskupdateconfig = Set-AzDiskUpdateKeyEncryptionKey -DiskUpdate $diskupdateconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
Update-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DiskUpdate $diskupdateconfig;

Der erste Befehl erstellt ein lokales leeres Datenträgeraktualisierungsobjekt mit einer Größe von 10 GB in Premium_LRS Speicherkontotyp. Außerdem wird der Windows-Betriebssystemtyp festgelegt und Verschlüsselungseinstellungen aktiviert. Mit den zweiten und dritten Befehlen werden der Datenträgerverschlüsselungsschlüssel und die Schlüsselverschlüsselungsschlüsseleinstellungen für das Datenträgeraktualisierungsobjekt festgelegt. Der letzte Befehl verwendet das Datenträgeraktualisierungsobjekt und aktualisiert einen vorhandenen Datenträger mit dem Namen "Disk01" in der Ressourcengruppe "ResourceGroup01".

Beispiel 2

New-AzDiskUpdateConfig -DiskSizeGB 10 | Update-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01';

Mit diesem Befehl wird ein vorhandener Datenträger mit dem Namen "Disk01" in der Ressourcengruppe "ResourceGroup01" auf 10 GB Datenträgergröße aktualisiert.

Parameter

-AcceleratedNetwork

True, wenn das Image, von dem der Betriebssystemdatenträger erstellt wird, beschleunigte Netzwerke unterstützt.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Architecture

Cpu-Architektur, die von einem Betriebssystemdatenträger unterstützt wird. Mögliche Werte sind "X64" und "Arm64".

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

-BurstingEnabled

Ermöglicht das Bursting über das bereitgestellte Leistungsziel des Datenträgers hinaus. Bursting ist standardmäßig deaktiviert. Gilt nicht für Ultra-Datenträger.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-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

-DataAccessAuthMode

Zusätzliche Authentifizierungsanforderungen beim Exportieren oder Hochladen auf einen Datenträger oder eine Momentaufnahme.

Typ:String
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

-DiskAccessId

ARM-ID der DiskAccess-Ressource für die Verwendung privater Endpunkte auf Datenträgern

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

-DiskEncryptionKey

Gibt das Datenträgerverschlüsselungsschlüsselobjekt auf einem Datenträger an.

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

-DiskEncryptionSetId

Gibt die Ressourcen-ID des Datenträgerverschlüsselungssatzes an, der zum Aktivieren der ruhenden Verschlüsselung verwendet werden soll.

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

-DiskIOPSReadOnly

Die Gesamtzahl der IOPS, die für alle virtuellen Computer zulässig sind, die den freigegebenen Datenträger als ReadOnly bereitstellen. Ein Vorgang kann zwischen 4k und 256k Bytes übertragen.

Typ:Nullable<T>[Int64]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DiskIOPSReadWrite

Die Anzahl der für diesen Datenträger zulässigen IOPS; nur für UltraSSD-Datenträger verfügbar. Ein Vorgang kann zwischen 4k und 256k Bytes übertragen.

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

-DiskMBpsReadOnly

Der Gesamtdurchsatz (MBps), der für alle virtuellen Computer zulässig ist, die den freigegebenen Datenträger als ReadOnly bereitstellen. MBps bedeutet Millionen von Bytes pro Sekunde - MB verwendet hier die ISO-Notation, von Mächten von 10.

Typ:Nullable<T>[Int64]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DiskMBpsReadWrite

Die für diesen Datenträger zulässige Bandbreite; nur für UltraSSD-Datenträger verfügbar. MBps bedeutet Millionen von Bytes pro Sekunde - MB verwendet hier die ISO-Notation, von Mächten von 10.

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

-DiskSizeGB

Gibt die Größe des Datenträgers in GB an.

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

-EncryptionSettingsEnabled

Aktivieren von Verschlüsselungseinstellungen auf dem Datenträger

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-EncryptionType

Der Schlüsseltyp, der zum Verschlüsseln der Daten des Datenträgers verwendet wird. Verfügbare Werte sind: EncryptionAtRestWithPlatformKey, EncryptionAtRestWithCustomerKey

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

-KeyEncryptionKey

Gibt den Schlüsselverschlüsselungsschlüssel auf einem Datenträger an.

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

-MaxSharesCount

Die maximale Anzahl von virtuellen Computern, die gleichzeitig an den Datenträger angefügt werden können. Der Wert größer als ein Wert gibt einen Datenträger an, der gleichzeitig auf mehreren virtuellen Computern bereitgestellt werden kann.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NetworkAccessPolicy

Richtlinie für den Zugriff auf den Datenträger über das Netzwerk. Verfügbare Werte sind: AllowAll, AllowPrivate, DeyAll

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

-OsType

Gibt den Betriebssystemtyp an.

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

-PublicNetworkAccess

Richtlinie zum Steuern des Exports auf dem Datenträger.

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

-PurchasePlan

Legt den Einkaufsplan für den Datenträger fest. Wird zum Einrichten des Kaufkontexts eines Drittanbieterartefaktes über Marketplace verwendet.

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

-SkuName

Gibt den Sku-Namen des Speicherkontos an. Verfügbare Werte sind Standard_LRS, Premium_LRS, StandardSSD_LRS und UltraSSD_LRS. UltraSSD_LRS kann nur mit leerem Wert für createOption-Parameter verwendet werden.

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

-SupportsHibernation

Gibt an, ob das Betriebssystem auf dem Datenträger den Ruhezustand mit $true oder $false

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

Leistungsebene des Datenträgers.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
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

String

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

Int32

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

KeyVaultAndSecretReference

KeyVaultAndKeyReference

Ausgaben

PSDiskUpdate