Udostępnij za pośrednictwem

New-AzDiskConfig

  • Odwołanie
Moduł:
Az.Compute

Tworzy konfigurowalny obiekt dysku.

Składnia

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

Opis

Polecenie cmdlet New-AzDiskConfig tworzy konfigurowalny obiekt dysku.

Przykłady

Przykład 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;

Pierwsze polecenie tworzy lokalny pusty obiekt dysku o rozmiarze 5 GB w typie konta magazynu Standard_LRS. Ustawia również typ systemu operacyjnego Windows i włącza ustawienia szyfrowania. Drugie i trzecie polecenia ustawiają ustawienia klucza szyfrowania dysku i klucza szyfrowania klucza dla obiektu dysku. Ostatnie polecenie pobiera obiekt dysku i tworzy dysk o nazwie "Disk01" w grupie zasobów "ResourceGroup01".

Przykład 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'

Pierwsze polecenie tworzy obiekt dysku lokalnego na potrzeby przekazywania. Drugie polecenie pobiera obiekt dysku i tworzy dysk o nazwie "Disk01" w grupie zasobów "ResourceGroup01". Trzecie polecenie pobiera adres URL sygnatury dostępu współdzielonego dla dysku. Czwarte polecenie pobiera stan dysku. Jeśli stan dysku to "ReadyToUpload", użytkownik może przekazać dysk z magazynu obiektów blob do adresu URL sygnatury dostępu współdzielonego dysku przy użyciu narzędzia AzCopy. Podczas przekazywania stan dysku jest zmieniany na "ActiveUpload". Ostatnie polecenie odwołuje dostęp do dysku dla adresu URL sygnatury dostępu współdzielonego.

Przykład 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

Utwórz dysk na podstawie wersji obrazu galerii udostępnionej. Identyfikator to identyfikator wersji obrazu galerii udostępnionej. Numer LUN jest wymagany tylko wtedy, gdy źródło jest dyskiem danych.

Przykład 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

Utwórz dysk z parametrem OptimizedForFrequentAttach na wartość true, aby zwiększyć niezawodność i wydajność dysków danych, które będą często (ponad 5 razy dziennie) odłączane od jednej maszyny wirtualnej i dołączone do innej.

Parametry

-AcceleratedNetwork

Prawda, jeśli obraz, z którego jest tworzony dysk systemu operacyjnego, obsługuje przyspieszoną sieć.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Architecture

Architektura procesora CPU obsługiwana przez dysk systemu operacyjnego. Możliwe wartości to "X64" i "Arm64".

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-BurstingEnabled

Umożliwia zwiększenie wydajności poza aprowizowaną wartość docelową wydajności dysku. Skalowanie jest domyślnie wyłączone. Nie dotyczy dysków w warstwie Ultra.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CreateOption

Określa, czy to polecenie cmdlet tworzy dysk na maszynie wirtualnej na podstawie platformy lub obrazu użytkownika, tworzy pusty dysk lub dołącza istniejący dysk.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DataAccessAuthMode

Dodatkowe wymagania dotyczące uwierzytelniania podczas eksportowania lub przekazywania do dysku lub migawki.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DiskAccessId

Pobiera lub ustawia identyfikator usługi ARM zasobu DiskAccess na potrzeby korzystania z prywatnych punktów końcowych.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskEncryptionKey

Określa obiekt klucza szyfrowania dysku na dysku.

Typ:KeyVaultAndSecretReference
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskEncryptionSetId

Określa identyfikator zasobu zestawu szyfrowania dysku, który ma być używany do włączania szyfrowania magazynowanych.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskIOPSReadOnly

Całkowita liczba operacji we/wy na sekundę, która będzie dozwolona na wszystkich maszynach wirtualnych instalowania dysku udostępnionego jako ReadOnly. Jedna operacja może przesyłać od 4k do 256 tys. bajtów.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskIOPSReadWrite

Liczba operacji we/wy na sekundę dozwolonych dla tego dysku; można ustawić tylko dla dysków UltraSSD. Jedna operacja może przesyłać od 4k do 256 tys. bajtów.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskMBpsReadOnly

Łączna przepływność (MB/s), która będzie dozwolona na wszystkich maszynach wirtualnych instalowania dysku udostępnionego jako ReadOnly. Mb/s oznacza miliony bajtów na sekundę - MB w tym miejscu używa notacji ISO, mocy 10.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskMBpsReadWrite

Dozwolona przepustowość dla tego dysku; można ustawić tylko dla dysków UltraSSD. Mb/s oznacza miliony bajtów na sekundę - MB w tym miejscu używa notacji ISO, mocy 10.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DiskSizeGB

Określa rozmiar dysku w GB.

Typ:Int32
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EdgeZone

Ustawia nazwę strefy krawędzi. W przypadku ustawienia zapytanie będzie kierowane do określonej strefy brzegowej zamiast do regionu głównego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EncryptionSettingsEnabled

Włącz ustawienia szyfrowania.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EncryptionType

Typ klucza używanego do szyfrowania danych dysku. Dostępne wartości to: "EncryptionAtRestWithPlatformKey", "EncryptionAtRestWithCustomerKey"

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-GalleryImageReference

Obiekt GalleryImageReference. Wymagane w przypadku tworzenia na podstawie obrazu galerii. Identyfikator będzie identyfikatorem ARM udostępnionej wersji obrazu galley, z której ma zostać utworzony dysk. Jednostka lun jest wymagana, jeśli źródłem kopii jest jeden z dysków danych na obrazie galerii; jeśli ma wartość null, dysk systemu operacyjnego obrazu zostanie skopiowany.

Typ:ImageDiskReference
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-HyperVGeneration

Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego. Dozwolone wartości to V1 i V2.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ImageReference

Określa odwołanie do obrazu na dysku. Identyfikator będzie identyfikatorem ARM obrazu PIR lub użytkownika, z którego ma zostać utworzony dysk. Jednostka LUN jest wymagana, jeśli źródłem kopii jest jeden z dysków danych na obrazie galerii; jeśli ma wartość null, dysk systemu operacyjnego obrazu zostanie skopiowany.

Typ:ImageDiskReference
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-KeyEncryptionKey

Określa klucz szyfrowania klucza na dysku.

Typ:KeyVaultAndKeyReference
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Location

Określa lokalizację.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LogicalSectorSize

Rozmiar sektora logicznego w bajtach dla dysków w warstwie Ultra.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MaxSharesCount

Maksymalna liczba maszyn wirtualnych, które mogą być dołączane do dysku w tym samym czasie. Wartość większa niż jedna wskazuje dysk, który można instalować na wielu maszynach wirtualnych jednocześnie.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NetworkAccessPolicy

Zasady dostępu do sieci definiują zasady dostępu do sieci. Możliwe wartości obejmują: "AllowAll", "AllowPrivate", "DenyAll"

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-OptimizedForFrequentAttach

Ustawienie tej właściwości na wartość true zwiększa niezawodność i wydajność dysków danych, które są często (więcej niż 5 razy dziennie) przez odłączenie od jednej maszyny wirtualnej i dołączone do innej. Ta właściwość nie powinna być ustawiana dla dysków, które nie są odłączone i dołączone często, ponieważ powoduje, że dyski nie są zgodne z domeną błędów maszyny wirtualnej.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-OsType

Określa typ systemu operacyjnego.

Typ:Nullable<T>[OperatingSystemTypes]
Dopuszczalne wartości:Windows, Linux
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PerformancePlus

Ustaw tę flagę na wartość true, aby zwiększyć wydajność docelową wdrożonego dysku, zobacz tutaj w odpowiednim celu wydajności. Tę flagę można ustawić tylko w czasie tworzenia dysku i nie można jej wyłączyć po włączeniu.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PublicNetworkAccess

Zasady kontrolowania eksportu na dysku.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PurchasePlan

Określa plan zakupu dysku.

Typ:PSPurchasePlan
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SkuName

Określa nazwę jednostki SKU konta magazynu. Dostępne wartości to Standard_LRS, Premium_LRS, StandardSSD_LRS i UltraSSD_LRS, Premium_ZRS i StandardSSD_ZRS. UltraSSD_LRS można używać tylko z wartością Empty parametru CreateOption.

Typ:String
Aliasy:AccountType
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SourceResourceId

Określa identyfikator zasobu źródłowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SourceUri

Określa źródłowy identyfikator URI.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountId

Określa identyfikator konta magazynu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SupportsHibernation

Klienci mogą ustawić flagę SupportHibernation na dysku.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tier

Warstwa wydajności dysku.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UploadSizeInBytes

Określa rozmiar zawartości przekazywania, w tym stopkę dysku VHD, gdy parametr CreateOption to Upload. Ta wartość powinna należeć do 20972032 (20 bajtów MiB + 512 dla stopki dysku VHD) i 35183298347520 bajtów (32 TiB + 512 bajtów dla stopki dysku VHD).

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Zone

Określa listę stref logicznych dla dysku.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

PSDisk