New-AzDiskConfig
Skapar ett konfigurerbart diskobjekt.
Syntax
Default (Standard)
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>]
[-SecurityMetadataUri <String>]
[-SecurityDataUri <String>]
[-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.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-Architecture
CPU-arkitektur som stöds av en OS-disk. Möjliga värden är "X64" och "Arm64".
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-BurstingEnabled
Aktiverar burst-prestanda utöver diskens etablerade prestandamål. Bursting är inaktiverat som standard. Gäller inte för Ultra-diskar.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: jfr
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: 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.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-DataAccessAuthMode
Ytterligare autentiseringskrav vid export eller uppladdning till en disk eller ögonblicksbild.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Parameteregenskaper
Typ: IAzureContextContainer
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DiskAccessId
Hämtar eller anger ARM-ID för DiskAccess-resursen för användning av privata slutpunkter på.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-DiskEncryptionKey
Anger diskkrypteringsnyckelobjektet på en disk.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-DiskEncryptionSetId
Anger resurs-ID för diskkrypteringsuppsättningen som ska användas för att aktivera kryptering i vila.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-DiskSizeGB
Anger storleken på disken i GB.
Parameteregenskaper
Typ: Int32
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: 2
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-EdgeZone
Anger gränszonens namn. Om den anges dirigeras frågan till den angivna gränszonen i stället för huvudregionen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-EncryptionSettingsEnabled
Aktivera krypteringsinställningar.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-EncryptionType
Den typ av nyckel som används för att kryptera diskens data. Tillgängliga värden är: "EncryptionAtRestWithPlatformKey", "EncryptionAtRestWithCustomerKey"
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-HyperVGeneration
Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar. Tillåtna värden är V1 och V2.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-KeyEncryptionKey
Anger nyckelkrypteringsnyckeln på en disk.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-Location
Anger en plats.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: 3
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-LogicalSectorSize
Logisk sektorstorlek i byte för Ultra-diskar.
Parameteregenskaper
Typ: Int32
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Typ: Int32
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-NetworkAccessPolicy
Nätverksåtkomstprincip definierar principen för nätverksåtkomst.
Möjliga värden är: "AllowAll", "AllowPrivate", "DenyAll"
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-OsType
Anger operativsystemets typ.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: 1
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
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.
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-PublicNetworkAccess
Princip för att kontrollera exporten på disken.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-PurchasePlan
Anger inköpsplanen för disken.
Parameteregenskaper
Typ: PSPurchasePlan
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-SecurityDataUri
Om createOption är ImportSecure är detta URI för en blob som ska importeras till vm-gästtillstånd.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
Om createOption är ImportSecure är detta URI:n för en blob som ska importeras till VM-metadata för konfidentiell virtuell dator.
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: Kontotyp
Parameteruppsättningar
(All)
Position: 0
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-SourceResourceId
Anger källresurs-ID: t.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-SourceUri
Anger käll-URI:n.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-StorageAccountId
Anger lagringskontots ID.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-SupportsHibernation
Kunder kan ange flaggan SupportsHibernation på disken.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-Tag
Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}
Parameteregenskaper
Typ: Hashtable
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-Tier
Diskens prestandanivå.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: 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).
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: Wi
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Zone
Anger listan över logiska zoner för Disk.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: True
Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata