New-AzDiskConfig

  • 참조
모듈:
Az.Compute

구성 가능한 디스크 개체를 만듭니다.

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

New-AzDiskConfig cmdlet은 구성 가능한 디스크 개체를 만듭니다.

예제

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

첫 번째 명령은 Standard_LRS 스토리지 계정 유형에서 크기가 5GB인 로컬 빈 디스크 개체를 만듭니다. 또한 Windows OS 유형을 설정하고 암호화 설정을 사용하도록 설정합니다. 두 번째 및 세 번째 명령은 디스크 개체에 대한 디스크 암호화 키 및 키 암호화 키 설정을 설정합니다. 마지막 명령은 디스크 개체를 사용하고 리소스 그룹 'ResourceGroup01'에 이름이 'Disk01'인 디스크를 만듭니다.

예제 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'

첫 번째 명령은 업로드에 대한 로컬 디스크 개체를 만듭니다. 두 번째 명령은 디스크 개체를 사용하고 리소스 그룹 'ResourceGroup01'에 이름이 'Disk01'인 디스크를 만듭니다. 세 번째 명령은 디스크에 대한 SAS URL을 가져옵니다. 네 번째 명령은 디스크의 상태를 가져옵니다. 디스크 상태가 'ReadyToUpload'인 경우 사용자는 AzCopy를 사용하여 Blob Storage에서 디스크 SAS URL로 디스크를 업로드할 수 있습니다. 업로드하는 동안 디스크 상태가 'ActiveUpload'로 변경됩니다. 마지막 명령은 SAS URL에 대한 디스크 액세스를 취소합니다.

예 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

공유 갤러리 이미지 버전에서 디스크를 만듭니다. ID는 공유 갤러리 이미지 버전의 ID입니다. Lun은 원본이 데이터 디스크인 경우에만 필요합니다.

예시 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

OptimizedForFrequentAttach를 true로 사용하여 디스크를 만들어 한 가상 머신에서 분리되고 다른 가상 머신에서 자주(하루에 5회 이상) 연결될 데이터 디스크의 안정성과 성능을 향상시킵니다.

매개 변수

-AcceleratedNetwork

TRUE이면 OS 디스크를 만든 이미지가 가속화된 네트워킹을 지원합니다.

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

-Architecture

OS 디스크에서 지원하는 CPU 아키텍처입니다. 가능한 값은 "X64" 및 "Arm64"입니다.

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

-BurstingEnabled

디스크의 프로비전된 성능 목표를 초과하여 버스팅을 사용하도록 설정합니다. 버스팅은 기본적으로 사용하지 않도록 설정되어 있습니다. Ultra 디스크에는 적용되지 않습니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-CreateOption

이 cmdlet은 플랫폼 또는 사용자 이미지에서 가상 머신에 디스크를 만들거나, 빈 디스크를 만들거나, 기존 디스크를 연결할지 여부를 지정합니다.

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

-DataAccessAuthMode

디스크 또는 스냅샷 내보내거나 업로드할 때 추가 인증 요구 사항입니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-DiskAccessId

프라이빗 엔드포인트를 사용하기 위한 DiskAccess 리소스의 ARM ID를 가져오거나 설정합니다.

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

-DiskEncryptionKey

디스크의 디스크 암호화 키 개체를 지정합니다.

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

-DiskEncryptionSetId

미사용 암호화를 사용하도록 설정하는 데 사용할 디스크 암호화 집합의 리소스 ID를 지정합니다.

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

-DiskIOPSReadOnly

공유 디스크를 ReadOnly로 탑재하는 모든 VM에서 허용되는 총 IOPS 수입니다. 하나의 작업은 4k에서 256k 바이트 사이를 전송할 수 있습니다.

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

-DiskIOPSReadWrite

이 디스크에 허용되는 IOPS 수입니다. UltraSSD 디스크에 대해서만 설정할 수 있습니다. 하나의 작업은 4k에서 256k 바이트 사이를 전송할 수 있습니다.

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

-DiskMBpsReadOnly

공유 디스크를 ReadOnly로 탑재하는 모든 VM에서 허용되는 총 처리량(MBps)입니다. MBps는 초당 수백만 바이트를 의미합니다. 여기서 MB는 10의 강력한 ISO 표기법을 사용합니다.

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

-DiskMBpsReadWrite

이 디스크에 허용되는 대역폭입니다. UltraSSD 디스크에 대해서만 설정할 수 있습니다. MBps는 초당 수백만 바이트를 의미합니다. 여기서 MB는 10의 강력한 ISO 표기법을 사용합니다.

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

-DiskSizeGB

디스크 크기를 GB 단위로 지정합니다.

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

-EdgeZone

에지 영역 이름을 설정합니다. 설정된 경우 쿼리는 기본 지역 대신 지정된 에지존으로 라우팅됩니다.

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

-EncryptionSettingsEnabled

암호화 설정을 사용하도록 설정합니다.

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

-EncryptionType

디스크의 데이터를 암호화하는 데 사용되는 키 유형입니다. 사용 가능한 값은 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'입니다.

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

-GalleryImageReference

GalleryImageReference 개체입니다. 갤러리 이미지에서 만드는 경우 필수입니다. ID는 디스크를 만들 공유 갤리 이미지 버전의 ARM ID입니다. 복사본 원본이 갤러리 이미지의 데이터 디스크 중 하나인 경우 lun이 필요합니다. null이면 이미지의 OS 디스크가 복사됩니다.

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

-HyperVGeneration

Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다. 허용되는 값은 V1 및 V2입니다.

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

-ImageReference

디스크의 이미지 참조를 지정합니다. ID는 디스크를 만들 PIR 또는 사용자 이미지의 ARM ID입니다. 복사본 원본이 갤러리 이미지의 데이터 디스크 중 하나인 경우 LUN이 필요합니다. null이면 이미지의 OS 디스크가 복사됩니다.

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

-KeyEncryptionKey

디스크의 키 암호화 키를 지정합니다.

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

-Location

위치를 지정합니다.

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

-LogicalSectorSize

Ultra 디스크의 논리적 섹터 크기(바이트)입니다.

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

-MaxSharesCount

디스크에 동시에 연결할 수 있는 최대 VM 수입니다. 1보다 큰 값은 동시에 여러 VM에 탑재할 수 있는 디스크를 나타냅니다.

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

-NetworkAccessPolicy

네트워크 액세스 정책은 네트워크 액세스 정책을 정의합니다. 가능한 값은 'AllowAll', 'AllowPrivate', 'DenyAll'입니다.

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

-OptimizedForFrequentAttach

이 속성을 true로 설정하면 한 가상 머신에서 분리되고 다른 가상 머신에 연결하여 자주(하루에 5회 이상) 데이터 디스크의 안정성과 성능이 향상됩니다. 이 속성은 분리되지 않고 자주 연결되지 않은 디스크에 대해 설정해서는 안 됩니다. 이로 인해 디스크가 가상 머신의 오류와 일치하지 않으므로기본.

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

-OsType

OS 유형을 지정합니다.

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

-PerformancePlus

배포된 디스크의 성능 목표를 향상시키려면 이 플래그를 true로 설정합니다. 각 성능 대상은 여기를 참조하세요. 이 플래그는 디스크 생성 시간에만 설정할 수 있으며 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.

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

-PublicNetworkAccess

디스크에서 내보내기를 제어하는 정책입니다.

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

-PurchasePlan

디스크에 대한 구매 계획을 지정합니다.

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

-SkuName

스토리지 계정의 Sku 이름을 지정합니다. 사용 가능한 값은 Standard_LRS, Premium_LRS, StandardSSD_LRS 및 UltraSSD_LRS, Premium_ZRS 및 StandardSSD_ZRS. UltraSSD_LRS CreateOption 매개 변수의 빈 값과 함께만 사용할 수 있습니다.

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

-SourceResourceId

원본 리소스 ID를 지정합니다.

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

-SourceUri

원본 URI를 지정합니다.

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

-StorageAccountId

스토리지 계정 ID를 지정합니다.

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

-SupportsHibernation

고객은 디스크에서 SupportsHibernation 플래그를 설정할 수 있습니다.

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

-Tag

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

디스크의 성능 계층입니다.

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

-UploadSizeInBytes

CreateOption이 업로드될 때 VHD 바닥글을 포함하여 업로드 내용의 크기를 지정합니다. 이 값은 20972032(VHD 바닥글의 경우 20MiB + 512바이트) 및 35183298347520 바이트(VHD 바닥글의 경우 32TiB + 512바이트) 사이여야 합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

-Zone

디스크의 논리 영역 목록을 지정합니다.

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

입력

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

출력

PSDisk