Delen via


New-AzDiskConfig

Hiermee maakt u een configureerbaar schijfobject.

Syntaxis

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>]

Description

Met de cmdlet New-AzDiskConfig wordt een configureerbaar schijfobject gemaakt.

Voorbeelden

Voorbeeld 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;

Met de eerste opdracht maakt u een lokaal leeg schijfobject met de grootte van 5 GB in Standard_LRS opslagaccounttype. Ook wordt het type Windows-besturingssysteem ingesteld en worden versleutelingsinstellingen ingeschakeld. Met de tweede en derde opdrachten worden de instellingen voor schijfversleutelingssleutel en sleutelversleutelingssleutel voor het schijfobject ingesteld. Met de laatste opdracht wordt het schijfobject gebruikt en wordt een schijf gemaakt met de naam Disk01 in de resourcegroep ResourceGroup01.

Voorbeeld 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'

Met de eerste opdracht maakt u een lokaal schijfobject voor Uploaden. Met de tweede opdracht wordt het schijfobject gebruikt en wordt een schijf gemaakt met de naam Disk01 in de resourcegroep ResourceGroup01. Met de derde opdracht wordt de SAS-URL voor de schijf opgeslagen. Met de vierde opdracht krijgt u de status van de schijf. Als de schijfstatus ReadyToUpload is, kan een gebruiker een schijf van blobopslag uploaden naar de SAS-URL van de schijf met behulp van AzCopy. Tijdens het uploaden wordt de schijfstatus gewijzigd in 'ActiveUpload'. Met de laatste opdracht wordt de schijftoegang voor de SAS-URL ingetrokken.

Voorbeeld 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

Maak een schijf op basis van een installatiekopieënversie van een gedeelde galerie. Id is de id van de installatiekopieënversie van de gedeelde galerie. Lun is alleen nodig als de bron een gegevensschijf is.

Voorbeeld 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

Maak een schijf met OptimizedForFrequentAttach als true om de betrouwbaarheid en prestaties van de gegevensschijven te verbeteren die vaak (meer dan 5 keer per dag) worden losgekoppeld van de ene virtuele machine en aan een andere worden gekoppeld.

Parameters

-AcceleratedNetwork

Is waar als de installatiekopieën van waaruit de besturingssysteemschijf wordt gemaakt, ondersteuning bieden voor versneld netwerken.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Architecture

CPU-architectuur die wordt ondersteund door een besturingssysteemschijf. Mogelijke waarden zijn X64 en Arm64.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-BurstingEnabled

Maakt bursting mogelijk buiten het ingerichte prestatiedoel van de schijf. Bursting is standaard uitgeschakeld. Is niet van toepassing op Ultra-schijven.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CreateOption

Hiermee geeft u op of met deze cmdlet een schijf in de virtuele machine wordt gemaakt op basis van een platform- of gebruikersinstallatiekopieën, een lege schijf wordt gemaakt of een bestaande schijf wordt gekoppeld.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DataAccessAuthMode

Aanvullende verificatievereisten bij het exporteren of uploaden naar een schijf of momentopname.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DiskAccessId

Hiermee haalt u de ARM-id van de DiskAccess-resource op voor het gebruik van privé-eindpunten op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskEncryptionKey

Hiermee geeft u het schijfversleutelingssleutelobject op een schijf.

Type:KeyVaultAndSecretReference
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskEncryptionSetId

Hiermee geeft u de resource-id op van de schijfversleuteling die moet worden gebruikt voor het inschakelen van versleuteling at rest.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskIOPSReadOnly

Het totale aantal IOPS dat wordt toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. Eén bewerking kan worden overgedragen tussen 4k en 256k bytes.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskIOPSReadWrite

Het aantal IOPS dat is toegestaan voor deze schijf; alleen instelbaar voor UltraSSD-schijven. Eén bewerking kan worden overgedragen tussen 4k en 256k bytes.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskMBpsReadOnly

De totale doorvoer (MBps) die wordt toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. MBps betekent miljoenen bytes per seconde- MB maakt hier gebruik van de ISO-notatie, van bevoegdheden van 10.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskMBpsReadWrite

De bandbreedte die voor deze schijf is toegestaan; alleen instelbaar voor UltraSSD-schijven. MBps betekent miljoenen bytes per seconde- MB maakt hier gebruik van de ISO-notatie, van bevoegdheden van 10.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DiskSizeGB

Hiermee geeft u de grootte van de schijf in GB.

Type:Int32
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EdgeZone

Hiermee stelt u de naam van de randzone in. Als deze optie is ingesteld, wordt de query doorgestuurd naar de opgegeven edgezone in plaats van de hoofdregio.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EncryptionSettingsEnabled

Schakel versleutelingsinstellingen in.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-EncryptionType

Het type sleutel dat wordt gebruikt om de gegevens van de schijf te versleutelen. Beschikbare waarden zijn: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-GalleryImageReference

Het Object GalleryImageReference. Vereist als u een galerie-installatiekopieën maakt. De id is de ARM-id van de versie van de gedeelde kombuisinstallatiekopie waaruit een schijf moet worden gemaakt. Er is een lun nodig als de bron van de kopie een van de gegevensschijven in de galerie-installatiekopie is; indien null, wordt de besturingssysteemschijf van de installatiekopieën gekopieerd.

Type:ImageDiskReference
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-HyperVGeneration

De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven. Toegestane waarden zijn V1 en V2.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ImageReference

Hiermee geeft u de installatiekopieënreferentie op een schijf. De id is de ARM-id van de PIR- of gebruikersinstallatiekopieën waaruit een schijf moet worden gemaakt. Er is een LUN nodig als de bron van de kopie een van de gegevensschijven in de galerie-installatiekopie is; indien null, wordt de besturingssysteemschijf van de installatiekopieën gekopieerd.

Type:ImageDiskReference
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-KeyEncryptionKey

Hiermee geeft u de sleutelversleutelingssleutel op een schijf.

Type:KeyVaultAndKeyReference
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u een locatie.

Type:String
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LogicalSectorSize

Grootte van logische sector in bytes voor Ultra-schijven.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-MaxSharesCount

Het maximum aantal virtuele machines dat tegelijkertijd aan de schijf kan worden gekoppeld. De waarde groter dan één geeft een schijf aan die tegelijkertijd op meerdere VM's kan worden gekoppeld.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NetworkAccessPolicy

Netwerktoegangsbeleid definieert het netwerktoegangsbeleid. Mogelijke waarden zijn: 'AllowAll', 'AllowPrivate', 'DenyAll'

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OptimizedForFrequentAttach

Als u deze eigenschap instelt op waar, verbetert u de betrouwbaarheid en prestaties van gegevensschijven die vaak (meer dan 5 keer per dag) worden uitgevoerd door los te koppelen van de ene virtuele machine en gekoppeld aan een andere. Deze eigenschap mag niet worden ingesteld voor schijven die niet vaak zijn losgekoppeld en gekoppeld, omdat de schijven niet overeenkomen met het foutdomein van de virtuele machine.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OsType

Hiermee geeft u het type besturingssysteem.

Type:Nullable<T>[OperatingSystemTypes]
Geaccepteerde waarden:Windows, Linux
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PerformancePlus

Stel deze vlag in op True om een boost te krijgen op het prestatiedoel van de schijf die is geïmplementeerd, zie hier over het respectieve prestatiedoel. Deze vlag kan alleen worden ingesteld op de aanmaaktijd van de schijf en kan niet worden uitgeschakeld nadat deze is ingeschakeld.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PublicNetworkAccess

Beleid voor het beheren van export op de schijf.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PurchasePlan

Hiermee geeft u het aankoopplan voor de schijf.

Type:PSPurchasePlan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SkuName

Hiermee geeft u de SKU-naam van het opslagaccount. Beschikbare waarden zijn Standard_LRS, Premium_LRS, StandardSSD_LRS en UltraSSD_LRS, Premium_ZRS en StandardSSD_ZRS. UltraSSD_LRS kan alleen worden gebruikt met de lege waarde voor de parameter CreateOption.

Type:String
Aliassen:AccountType
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SourceResourceId

Hiermee geeft u de bronresource-id op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SourceUri

Hiermee geeft u de bron-URI.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageAccountId

Hiermee geeft u de opslagaccount-id op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SupportsHibernation

Klanten kunnen de vlag SupportsHibernation instellen op de schijf.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tier

Prestatielaag van de schijf.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UploadSizeInBytes

Hiermee geeft u de grootte van de inhoud van de upload, inclusief de VHD-voettekst wanneer CreateOption is Geüpload. Deze waarde moet tussen 20972032 (20 MiB + 512 bytes voor de VHD-voettekst) en 35183298347520 bytes (32 TiB + 512 bytes voor de VHD-voettekst).

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Zone

Hiermee geeft u de lijst met logische zones voor Schijf.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

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

Uitvoerwaarden

PSDisk