New-AzDiskConfig

Referens

Modul:: Az.Compute

Skapar ett konfigurerbart diskobjekt.

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

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 storlek 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 diskens SAS-URL med hjälp av 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 delad galleribildversion. ID är ID:t för den delade galleribildversionen. Lun behövs bara om källan är en datadisk.

Exempel 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

Skapa en disk med OptimizedForFrequentAttach som sant för att förbättra tillförlitligheten och prestandan för de datadiskar som ofta (mer än 5 gånger om dagen) kopplas från en virtuell dator och kopplas till en annan.

Parametrar

-AcceleratedNetwork

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

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Architecture

CPU-arkitektur som stöds av en OS-disk. Möjliga värden är "X64" och "Arm64".

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-BurstingEnabled

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

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Confirm

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

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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 kopplar en befintlig disk.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DataAccessAuthMode

Ytterligare autentiseringskrav vid export eller uppladdning till en disk eller ögonblicksbild.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DiskAccessId

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DiskEncryptionKey

Anger diskkrypteringsnyckelobjektet på en disk.

Typ:	KeyVaultAndSecretReference
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DiskEncryptionSetId

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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 256 000 byte.

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DiskIOPSReadWrite

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

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DiskMBpsReadOnly

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 krafter på 10.

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DiskMBpsReadWrite

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

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DiskSizeGB

Anger storleken på disken i GB.

Typ:	Int32
Position:	2
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-EdgeZone

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-EncryptionSettingsEnabled

Aktivera krypteringsinställningar.

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-EncryptionType

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-GalleryImageReference

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

Typ:	ImageDiskReference
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-HyperVGeneration

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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 kopians källa är en av datadiskarna i galleribilden. om värdet är null kopieras os-disken för avbildningen.

Typ:	ImageDiskReference
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-KeyEncryptionKey

Anger nyckelkrypteringsnyckeln på en disk.

Typ:	KeyVaultAndKeyReference
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Location

Anger en plats.

Typ:	String
Position:	3
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-LogicalSectorSize

Logisk sektorstorlek i byte för Ultra-diskar.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-NetworkAccessPolicy

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-OptimizedForFrequentAttach

Om du ställer in den här egenskapen på true förbättras tillförlitligheten och prestandan för datadiskar som ofta (mer än 5 gånger om dagen) kopplas från en virtuell dator och kopplas till en annan. Den här egenskapen bör inte anges för diskar som inte kopplas från och ansluts ofta eftersom det gör att diskarna inte överensstämmer med feldomänen för den virtuella datorn.

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-OsType

Anger operativsystemets typ.

Typ:	Nullable<T>[OperatingSystemTypes]
Godkända värden:	Windows, Linux
Position:	1
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PerformancePlus

Ange den här flaggan till true för att få en ökning av prestandamålet för den distribuerade disken, se här på respektive prestandamål. Den här flaggan kan bara anges när disken skapas och kan inte inaktiveras när den har aktiverats.

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PublicNetworkAccess

Princip för att kontrollera exporten på disken.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PurchasePlan

Anger inköpsplanen för disken.

Typ:	PSPurchasePlan
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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.

Typ:	String
Alias:	AccountType
Position:	0
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SourceResourceId

Anger källresurs-ID: t.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SourceUri

Anger käll-URI:n.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-StorageAccountId

Anger lagringskontots ID.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SupportsHibernation

Kunder kan ange flaggan SupportsHibernation på disken.

Typ:	Nullable<T>[Boolean]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Tag

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

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Tier

Diskens prestandanivå.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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).

Typ:	Int64
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-WhatIf

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

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Zone

Anger listan över logiska zoner för Disk.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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

Dela via