New-AzDiskConfig

Składnia

Default (Domyślne)

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

Opis

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;

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'

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

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

Przykład 5

$accountType = <Account Type>
$sourceUri = <Source URI of the blob>
$storageAccountId = <Storage Account ID>
$diskConfig = New-AzDiskConfig -AccountType $accountType -CreateOption Import -SourceUri $sourceUri -StorageAccountId $storageAccountId -SupportedSecurityOption 'TrustedLaunchSupported'
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Parametry

-AcceleratedNetwork

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

Właściwości parametrów

Zbiory parametrów

-Architecture

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

Właściwości parametrów

Zbiory parametrów

-BurstingEnabled

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

Właściwości parametrów

Zbiory parametrów

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-DataAccessAuthMode

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

Właściwości parametrów

Zbiory parametrów

-DefaultProfile

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

Właściwości parametrów

Zbiory parametrów

-DiskAccessId

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

Właściwości parametrów

Zbiory parametrów

-DiskEncryptionKey

Określa obiekt klucza szyfrowania dysku na dysku.

Właściwości parametrów

Zbiory parametrów

-DiskEncryptionSetId

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-DiskSizeGB

Określa rozmiar dysku w GB.

Właściwości parametrów

Zbiory parametrów

-EdgeZone

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

Właściwości parametrów

Zbiory parametrów

-EncryptionSettingsEnabled

Włącz ustawienia szyfrowania.

Właściwości parametrów

Zbiory parametrów

-EncryptionType

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-HyperVGeneration

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-KeyEncryptionKey

Określa klucz szyfrowania klucza na dysku.

Właściwości parametrów

Zbiory parametrów

-Location

Określa lokalizację.

Właściwości parametrów

Zbiory parametrów

-LogicalSectorSize

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-NetworkAccessPolicy

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

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-OsType

Określa typ systemu operacyjnego.

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-PublicNetworkAccess

Zasady kontrolowania eksportu na dysku.

Właściwości parametrów

Zbiory parametrów

-PurchasePlan

Określa plan zakupu dysku.

Właściwości parametrów

Zbiory parametrów

-SecurityDataUri

Jeśli parametr createOption to ImportSecure, jest to identyfikator URI obiektu blob, który ma zostać zaimportowany do stanu gościa maszyny wirtualnej.

Właściwości parametrów

Zbiory parametrów

-SecurityMetadataUri

Jeśli createOption ma wartość ImportSecure, jest to identyfikator URI obiektu blob, który ma zostać zaimportowany do metadanych maszyny wirtualnej dla poufnej maszyny wirtualnej.

Właściwości parametrów

Zbiory parametrów

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

Właściwości parametrów

Zbiory parametrów

-SourceResourceId

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

Właściwości parametrów

Zbiory parametrów

-SourceUri

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

Właściwości parametrów

Zbiory parametrów

-StorageAccountId

Określa identyfikator konta magazynu.

Właściwości parametrów

Zbiory parametrów

-SupportedSecurityOption

Odwołuje się do możliwości zabezpieczeń dysku obsługiwanego w celu utworzenia zaufanej maszyny wirtualnej uruchamiania lub poufnej maszyny wirtualnej. Możliwe wartości to: "TrustedLaunchSupported", "TrustedLaunchAndConfidentialVMSupported"

Właściwości parametrów

Zbiory parametrów

-SupportsHibernation

Klienci mogą ustawić flagę SupportHibernation na dysku.

Właściwości parametrów

Zbiory parametrów

-Tag

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

Właściwości parametrów

Zbiory parametrów

-Tier

Warstwa wydajności dysku.

Właściwości parametrów

Zbiory parametrów

-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).

Właściwości parametrów

Zbiory parametrów

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Zbiory parametrów

-Zone

Określa listę stref logicznych dla dysku.

Właściwości parametrów

Zbiory parametrów

CommonParameters

Wejścia

String

Nullable<T>

Int32

String

Hashtable

ImageDiskReference

Nullable<T>

KeyVaultAndSecretReference

KeyVaultAndKeyReference

Wyjść

PSDisk