New-AzDiskConfig

Referentie

Module:: Az.Compute

Hiermee maakt u een configureerbaar schijfobject.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Met de cmdlet New-AzDiskConfig maakt u een configureerbaar schijfobject.

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 5 GB in Standard_LRS opslagaccounttype. Het stelt ook het type Windows-besturingssysteem in en schakelt versleutelingsinstellingen in. Met de tweede en derde opdrachten worden de instellingen voor schijfversleutelingssleutel en sleutelversleutelingssleutel voor het schijfobject ingesteld. Met de laatste opdracht wordt het schijfobject gemaakt 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 SAS-URL voor de schijf opgeslagen. Met de vierde opdracht wordt de status van de schijf ophaalt. 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.

Parameters

-AcceleratedNetwork

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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskEncryptionKey

Hiermee geeft u het object schijfversleutelingssleutel op een schijf.

Type:	KeyVaultAndSecretReference
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskEncryptionSetId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskMBpsReadOnly

"beschrijving": "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 hier maakt gebruik van de ISO-notatie, van machten van 10.

Type:	Int64
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskMBpsReadWrite

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

Type:	Int64
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskSizeGB

Hiermee geeft u de grootte van de schijf in GB.

Type:	Int32
Position:	2
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-EncryptionSettingsEnabled

Versleutelingsinstellingen inschakelen.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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; als null is, wordt de besturingssysteemschijf van de installatiekopieën gekopieerd.

Type:	ImageDiskReference
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-ImageReference

Hiermee geeft u de verwijzing naar de installatiekopieën 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; als null is, wordt de besturingssysteemschijf van de installatiekopieën gekopieerd.

Type:	ImageDiskReference
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyEncryptionKey

Hiermee geeft u de sleutelversleutelingssleutel op een schijf.

Type:	KeyVaultAndKeyReference
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Hiermee geeft u een locatie op.

Type:	String
Position:	3
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-LogicalSectorSize

Grootte logische sector in bytes voor Ultra-schijven.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxSharesCount

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkAccessPolicy

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OsType

Hiermee geeft u het type besturingssysteem op.

Type:	Nullable<T>[OperatingSystemTypes]
Accepted values:	Windows, Linux
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicNetworkAccess

Beleid voor het beheren van export op de schijf.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PurchasePlan

Hiermee geeft u het aankoopplan voor de schijf.

Type:	PSPurchasePlan
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Aliases:	AccountType
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SourceResourceId

Hiermee geeft u de bronresource-id op.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SourceUri

Hiermee geeft u de bron-URI.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountId

Hiermee geeft u de opslagaccount-id op.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SupportsHibernation

Klanten kunnen de vlag SupportsHibernation instellen op de schijf.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Tier

Prestatielaag van de schijf.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UploadSizeInBytes

Hiermee geeft u de grootte van de inhoud van de upload, inclusief de VHD-voettekst wanneer CreateOption is uploaden. 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
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

Hiermee geeft u de lijst met logische zones voor Schijf.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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