Freigeben über


New-AzDiskConfig

Erstellt ein konfigurierbares Datenträgerobjekt.

Syntax

New-AzDiskConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-LogicalSectorSize <Int32>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-Zone <String[]>]
   [-HyperVGeneration <String>]
   [-DiskIOPSReadWrite <Int64>]
   [-DiskMBpsReadWrite <Int64>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-Tag <Hashtable>]
   [-CreateOption <String>]
   [-StorageAccountId <String>]
   [-ImageReference <ImageDiskReference>]
   [-GalleryImageReference <ImageDiskReference>]
   [-SourceUri <String>]
   [-SourceResourceId <String>]
   [-UploadSizeInBytes <Int64>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-DiskAccessId <String>]
   [-NetworkAccessPolicy <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-PerformancePlus <Boolean>]
   [-OptimizedForFrequentAttach <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzDiskConfig erstellt ein konfigurierbares Datenträgerobjekt.

Beispiele

Beispiel 1

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 5 -SkuName Standard_LRS -OsType Windows -CreateOption Empty -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';
$diskconfig = Set-AzDiskDiskEncryptionKey -Disk $diskconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskconfig = Set-AzDiskKeyEncryptionKey -Disk $diskconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;

Der erste Befehl erstellt ein lokales leeres Datenträgerobjekt mit einer Größe von 5 GB in Standard_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ägerobjekt festgelegt. Der letzte Befehl verwendet das Datenträgerobjekt und erstellt einen Datenträger mit dem Namen "Disk01" in der Ressourcengruppe "ResourceGroup01".

Beispiel 2

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 1023 -SkuName Standard_LRS -OsType Windows -CreateOption Upload -DiskIOPSReadWrite 500 -DiskMBpsReadWrite 8;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;
$diskSas = Grant-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DurationInSecond 86400 -Access 'Write'
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ReadyToUpload'
 AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:$diskSas
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ActiveUpload'
Revoke-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'

Der erste Befehl erstellt ein lokales Datenträgerobjekt für Upload. Der zweite Befehl verwendet das Datenträgerobjekt und erstellt einen Datenträger mit dem Namen "Disk01" in der Ressourcengruppe "ResourceGroup01". Der dritte Befehl ruft die SAS-URL für den Datenträger ab. Der vierte Befehl ruft den Zustand des Datenträgers ab. Wenn der Datenträgerstatus "ReadyToUpload" lautet, kann ein Benutzer einen Datenträger aus blob-Speicher mithilfe von AzCopy in die SAS-URL des Datenträgers hochladen. Während des Uploads wird der Datenträgerzustand in "ActiveUpload" geändert. Der letzte Befehl widerruft den Datenträgerzugriff für die SAS-URL.

Beispiel 3

$galleryImageReference = @{Id = '/subscriptions/0296790d-427c-48ca-b204-8b729bbd8670/resourceGroups/swaggertests/providers/Microsoft.Compute/galleries/swaggergallery/images/swaggerimagedef/versions/1.0.0'; Lun=1}
$diskConfig = New-AzDiskConfig -Location 'West US' -CreateOption 'FromImage' -GalleryImageReference $galleryImageReference;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Erstellen Sie einen Datenträger aus einer Freigegebenen Katalogbildversion. Die ID ist die ID der freigegebenen Katalogbildversion. Lun ist nur erforderlich, wenn es sich bei der Quelle um einen Datenträger handelt.

Beispiel 4

$diskconfig = New-AzDiskConfig -Location 'Central US' -SkuName 'Standard_LRS' -OsType 'Windows' -UploadSizeInBytes 35183298347520 -CreateOption 'Upload' -OptimizedForFrequentAttach $true
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Erstellen Sie einen Datenträger mit "OptimizedForFrequentAttach" als "true", um die Zuverlässigkeit und Leistung der Datenträger zu verbessern, die häufig (mehr als 5 Mal täglich) von einem virtuellen Computer getrennt und an einen anderen angefügt werden.

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

-CreateOption

Gibt an, ob dieses Cmdlet einen Datenträger auf dem virtuellen Computer aus einer Plattform oder einem Benutzerimage erstellt, einen leeren Datenträger erstellt oder einen vorhandenen Datenträger anfügt.

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

Ruft die ARM-ID der DiskAccess-Ressource für die Verwendung privater Endpunkte ab oder legt sie fest.

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: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:Int64
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: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:Int64
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

-EdgeZone

Legt den Namen der Randzone fest. Wenn festgelegt, wird die Abfrage anstelle des Hauptbereichs an die angegebene Edgezone weitergeleitet.

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

-EncryptionSettingsEnabled

Verschlüsselungseinstellungen aktivieren.

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

-GalleryImageReference

Das GalleryImageReference-Objekt. Erforderlich, wenn sie aus einem Katalogbild erstellt werden. Die ID ist die ARM-ID der freigegebenen Galley-Imageversion, aus der ein Datenträger erstellt werden soll. Eine Lun ist erforderlich, wenn die Quelle der Kopie einer der Datenträger im Katalogbild ist; wenn NULL, wird der Betriebssystemdatenträger des Images kopiert.

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

-HyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. Zulässige Werte sind V1 und V2.

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

-ImageReference

Gibt den Imageverweis auf einem Datenträger an. Die ID ist die ARM-ID des PIR- oder Benutzerimages, aus dem ein Datenträger erstellt werden soll. Eine LUN ist erforderlich, wenn die Quelle der Kopie einer der Datenträger im Katalogbild ist; wenn NULL, wird der Betriebssystemdatenträger des Images kopiert.

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

-Location

Gibt einen Speicherort an.

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

-LogicalSectorSize

Logische Sektorgröße in Byte für Ultra-Datenträger.

Typ:Int32
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:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NetworkAccessPolicy

Die Netzwerkzugriffsrichtlinie definiert die Netzwerkzugriffsrichtlinie. Mögliche Werte sind: 'AllowAll', 'AllowPrivate', 'DenyAll'

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

-OptimizedForFrequentAttach

Wenn Sie diese Eigenschaft auf "true" festlegen, wird die Zuverlässigkeit und Leistung von Datenträgern verbessert, die häufig (mehr als 5 Mal pro Tag) von einem virtuellen Computer getrennt und an einen anderen angefügt werden. Diese Eigenschaft sollte nicht für Datenträger festgelegt werden, die nicht getrennt und häufig angefügt werden, da die Datenträger nicht an die Fehlerdomäne des virtuellen Computers ausgerichtet sind.

Typ:Nullable<T>[Boolean]
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

-PerformancePlus

Legen Sie dieses Kennzeichen auf "true" fest, um das Leistungsziel des bereitgestellten Datenträgers zu steigern. Weitere Informationen finden Sie hier im jeweiligen Leistungsziel. Dieses Kennzeichen kann nur für die Erstellungszeit des Datenträgers festgelegt werden und kann nach der Aktivierung nicht deaktiviert werden.

Typ:Nullable<T>[Boolean]
Position:Named
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

Gibt den Einkaufsplan für den Datenträger an.

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, Premium_ZRS und StandardSSD_ZRS. 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

-SourceResourceId

Gibt die Quellressourcen-ID an.

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

-SourceUri

Gibt den Quell-URI an.

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

-StorageAccountId

Gibt die Speicherkonto-ID an.

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

-SupportsHibernation

Kunden können das SupportsHibernation-Flag auf dem Datenträger festlegen.

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:Named
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

-UploadSizeInBytes

Gibt die Größe des Inhalts des Uploads an, einschließlich der VHD-Fußzeile beim Hochladen von CreateOption. Dieser Wert sollte zwischen 20972032 (20 MiB + 512 Bytes für die VHD-Fußzeile) und 35183298347520 Bytes (32 TiB + 512 Bytes für die VHD-Fußzeile) sein.

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

-Zone

Gibt die logische Zonenliste für den Datenträger an.

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

String[]

Hashtable

ImageDiskReference

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

KeyVaultAndSecretReference

KeyVaultAndKeyReference

Ausgaben

PSDisk