New-AzDiskConfig

Referens

Modul:: Az.Compute

Skapar ett konfigurerbart diskobjekt.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

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

Cmdleten New-AzDiskConfig skapar ett konfigurerbart diskobjekt.

Exempel

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

Det första kommandot skapar ett lokalt tomt diskobjekt med storleken 5 GB i Standard_LRS lagringskontotyp. Den anger även Windows OS-typ och aktiverar krypteringsinställningar. De andra och tredje kommandona anger diskkrypteringsnyckeln och nyckelkrypteringsnyckelinställningarna för diskobjektet. Det senaste kommandot tar diskobjektet och skapar en disk med namnet "Disk01" i resursgruppen "ResourceGroup01".

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

Det första kommandot skapar ett lokalt diskobjekt för uppladdning. Det andra kommandot tar diskobjektet och skapar en disk med namnet "Disk01" i resursgruppen "ResourceGroup01". Det tredje kommandot hämtar SAS-URL:en för disken. Det fjärde kommandot hämtar diskens tillstånd. Om disktillståndet är "ReadyToUpload" kan en användare ladda upp en disk från bloblagring till sas-url:en för disken med AzCopy. Under uppladdningen ändras disktillståndet till "ActiveUpload". Det senaste kommandot återkallar diskåtkomsten för SAS-URL:en.

Exempel 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

Skapa en disk från en avbildningsversion för delat galleri. ID är ID:t för den delade galleribildversionen. Lun behövs bara om källan är en datadisk.

Parametrar

-AcceleratedNetwork

Sant om avbildningen som OS-disken skapas från har stöd för accelererat nätverk.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-BurstingEnabled

Aktiverar burst-prestanda utöver diskens etablerade prestandamål. Bursting är inaktiverat som standard. Gäller inte för Ultra-diskar.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-CreateOption

Anger om den här cmdleten skapar en disk på den virtuella datorn från en plattform eller användarbild, skapar en tom disk eller ansluter en befintlig disk.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskAccessId

Hämtar eller anger ARM-ID för DiskAccess-resursen för användning av privata slutpunkter på.

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

-DiskEncryptionKey

Anger diskkrypteringsnyckelobjektet på en disk.

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

-DiskEncryptionSetId

Anger resurs-ID för diskkrypteringsuppsättningen som ska användas för att aktivera kryptering i vila.

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

-DiskIOPSReadOnly

Det totala antalet IOPS som tillåts för alla virtuella datorer som monterar den delade disken som ReadOnly. En åtgärd kan överföra mellan 4k och 256k byte.

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

-DiskIOPSReadWrite

Antalet tillåtna IOPS för den här disken. endast kan användas för UltraSSD-diskar. En åtgärd kan överföra mellan 4k och 256k byte.

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

-DiskMBpsReadOnly

"description": "Det totala dataflödet (Mbit/s) som tillåts för alla virtuella datorer som monterar den delade disken som ReadOnly. Mbit/s innebär miljontals byte per sekund – MB använder här ISO-notationen, med befogenheter på 10.

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

-DiskMBpsReadWrite

Den bandbredd som tillåts för den här disken. endast kan användas för UltraSSD-diskar. Mbit/s innebär miljontals byte per sekund – MB använder här ISO-notationen, med befogenheter på 10.

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

-DiskSizeGB

Anger storleken på disken i GB.

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

-EdgeZone

Anger gränszonens namn. Om den anges dirigeras frågan till den angivna gränszonen i stället för huvudregionen.

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

-EncryptionSettingsEnabled

Aktivera krypteringsinställningar.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-EncryptionType

Den typ av nyckel som används för att kryptera diskens data. Tillgängliga värden är: "EncryptionAtRestWithPlatformKey", "EncryptionAtRestWithCustomerKey"

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

-GalleryImageReference

GalleryImageReference-objektet. Krävs om du skapar från en galleribild. ID:t är ARM-ID:t för den delade galärversion som du kan skapa en disk från. En lun krävs om kopieringskällan är en av datadiskarna i galleribilden. om värdet är null kopieras os-disken för avbildningen.

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

-HyperVGeneration

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar. Tillåtna värden är V1 och V2.

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

-ImageReference

Anger avbildningsreferensen på en disk. ID:t är ARM-ID:t för piren eller användarbilden som du vill skapa en disk från. Ett LUN krävs om kopieringskällan är en av datadiskarna i galleribilden. om värdet är null kopieras os-disken för avbildningen.

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

-KeyEncryptionKey

Anger nyckelkrypteringsnyckeln på en disk.

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

-Location

Anger en plats.

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

-LogicalSectorSize

Logisk sektorstorlek i byte för Ultra-diskar.

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

-MaxSharesCount

Det maximala antalet virtuella datorer som kan anslutas till disken samtidigt. Värdet större än ett anger en disk som kan monteras på flera virtuella datorer samtidigt.

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

-NetworkAccessPolicy

Nätverksåtkomstprincip definierar principen för nätverksåtkomst. Möjliga värden är: "AllowAll", "AllowPrivate", "DenyAll"

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

-OsType

Anger operativsystemets typ.

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

-PublicNetworkAccess

Princip för att kontrollera exporten på disken.

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

-PurchasePlan

Anger inköpsplanen för disken.

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

-SkuName

Anger SKU-namnet på lagringskontot. Tillgängliga värden är Standard_LRS, Premium_LRS, StandardSSD_LRS och UltraSSD_LRS, Premium_ZRS och StandardSSD_ZRS. UltraSSD_LRS kan bara användas med tomt värde för parametern CreateOption.

Type:	String
Aliases:	AccountType
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SourceResourceId

Anger källresursens ID.

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

-SourceUri

Anger käll-URI:n.

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

-StorageAccountId

Anger lagringskontots ID.

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

-SupportsHibernation

Kunder kan ange flaggan SupportsHibernation på disken.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0";key1=$null;key2="value2"}

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

-Tier

Diskens prestandanivå.

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

-UploadSizeInBytes

Anger storleken på innehållet i uppladdningen, inklusive VHD-sidfoten när CreateOption är Uppladdning. Det här värdet ska vara mellan 20972032 (20 MiB + 512 byte för VHD-sidfoten) och 35183298347520 byte (32 TiB + 512 byte för VHD-sidfoten).

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

-Zone

Anger listan över logiska zoner för Disk.

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

Indata

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

Utdata

PSDisk