New-AzDiskConfig

  • Referencia
Modul:
Az.Compute

Konfigurálható lemezobjektum létrehozása.

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

A New-AzDiskConfig parancsmag konfigurálható lemezobjektumot hoz létre.

Példák

1. példa

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

Az első parancs létrehoz egy 5 GB méretű helyi üres lemezobjektumot Standard_LRS tárfióktípusban. Emellett beállítja a Windows operációs rendszer típusát, és engedélyezi a titkosítási beállításokat. A második és a harmadik parancs beállítja a lemeztitkosítási kulcsot és a lemezobjektum kulcstitkosítási kulcsának beállításait. Az utolsó parancs felveszi a lemezobjektumot, és létrehoz egy "Disk01" nevű lemezt a ResourceGroup01 erőforráscsoportban.

2. példa

$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'

Az első parancs létrehoz egy helyi lemezobjektumot a feltöltéshez. A második parancs felveszi a lemezobjektumot, és létrehoz egy "Disk01" nevű lemezt a ResourceGroup01 erőforráscsoportban. A harmadik parancs lekéri a lemez SAS URL-címét. A negyedik parancs lekéri a lemez állapotát. Ha a lemez állapota "ReadyToUpload", a felhasználó feltölthet egy lemezt a blobtárolóból a lemez SAS URL-címére az AzCopy használatával. A feltöltés során a lemez állapota "ActiveUpload" értékre módosul. Az utolsó parancs visszavonja az SAS URL-cím lemezhozzáférését.

3. példa

$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

Lemez létrehozása megosztott katalógus képverziójából. Az azonosító a megosztott katalógus képverziójának azonosítója. Lunra csak akkor van szükség, ha a forrás egy adatlemez.

4. példa

$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

Hozzon létre egy lemezt az OptimizedForFrequentAttach igaz értékével, hogy javítja a gyakran (naponta több mint ötször) leválasztott és egy másikhoz csatlakoztatott adatlemezek megbízhatóságát és teljesítményét.

Paraméterek

-AcceleratedNetwork

Igaz, ha az operációsrendszer-lemezt létrehozó rendszerkép támogatja a gyorsított hálózatkezelést.

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

-Architecture

Operációsrendszer-lemez által támogatott CPU-architektúra. Lehetséges értékek: "X64" és "Arm64".

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

-BurstingEnabled

Lehetővé teszi a lemez kiosztott teljesítménycélján túli kipukkadást. A kipukkadás alapértelmezés szerint le van tiltva. Az Ultra lemezekre nem vonatkozik.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-CreateOption

Megadja, hogy ez a parancsmag létrehoz-e egy lemezt a virtuális gépen egy platformról vagy felhasználói lemezképből, létrehoz-e üres lemezt, vagy csatol-e egy meglévő lemezt.

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

-DataAccessAuthMode

További hitelesítési követelmények lemez vagy pillanatkép exportálásakor vagy feltöltésekor.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-DiskAccessId

Lekéri vagy beállítja a DiskAccess-erőforrás ARM-azonosítóját a privát végpontok használatához.

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

-DiskEncryptionKey

Megadja a lemezen lévő lemeztitkosítási kulcs objektumát.

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

-DiskEncryptionSetId

Megadja annak a lemeztitkosítási csoportnak az erőforrás-azonosítóját, amelyet a inaktív titkosítás engedélyezéséhez használnak.

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

-DiskIOPSReadOnly

A megosztott lemezt olvasóként csatlakoztató összes virtuális gépen engedélyezett IOPS teljes száma. Egy művelet 4k és 256 000 bájt közötti átvitelre képes.

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

-DiskIOPSReadWrite

A lemezen engedélyezett IOPS száma; csak UltraSSD-lemezek esetén állítható be. Egy művelet 4k és 256 000 bájt közötti átvitelre képes.

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

-DiskMBpsReadOnly

A megosztott lemezt ReadOnlyként csatlakoztató összes virtuális gépen engedélyezett teljes átviteli sebesség (MBps). Az MBps másodpercenként több millió bájtot jelent – az MB itt a 10-es hatványú ISO-jelölést használja.

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

-DiskMBpsReadWrite

A lemezhez engedélyezett sávszélesség; csak UltraSSD-lemezek esetén állítható be. Az MBps másodpercenként több millió bájtot jelent – az MB itt a 10-es hatványú ISO-jelölést használja.

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

-DiskSizeGB

A lemez méretét adja meg GB-ban.

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

-EdgeZone

Beállítja az élzóna nevét. Ha be van állítva, a lekérdezés a fő régió helyett a megadott peremterületre lesz irányítva.

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

-EncryptionSettingsEnabled

Titkosítási beállítások engedélyezése.

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

-EncryptionType

A lemez adatainak titkosításához használt kulcs típusa. A rendelkezésre álló értékek a következők: "EncryptionAtRestWithPlatformKey", "EncryptionAtRestWithCustomerKey"

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

-GalleryImageReference

A GalleryImageReference objektum. Katalógusképből való létrehozáshoz szükséges. Az azonosító annak a megosztott galley-lemezkép-verziónak az ARM-azonosítója lesz, amelyből lemezt szeretne létrehozni. Lunra akkor van szükség, ha a másolat forrása a katalógus képének egyik adatlemeze; ha null, a rendszer a rendszerkép operációsrendszer-lemezét másolja.

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

-HyperVGeneration

A virtuális gép hipervizor-generációja. Csak operációsrendszer-lemezekre alkalmazható. Az engedélyezett értékek a V1 és a V2.

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

-ImageReference

A lemez képhivatkozását adja meg. Az azonosító annak a PIR-nek vagy felhasználói lemezképnek az ARM-azonosítója lesz, amelyből lemezt szeretne létrehozni. LuN-ra van szükség, ha a másolat forrása a katalógus képének egyik adatlemeze; ha null, a rendszer a rendszerkép operációsrendszer-lemezét másolja.

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

-KeyEncryptionKey

Megadja a lemez kulcstitkosítási kulcsát.

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

-Location

Egy helyet ad meg.

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

-LogicalSectorSize

Logikai szektor mérete bájtban ultralemezekhez.

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

-MaxSharesCount

A lemezhez egyidejűleg csatlakoztatható virtuális gépek maximális száma. Az egynél nagyobb érték olyan lemezt jelöl, amely egyszerre több virtuális gépre is csatlakoztatható.

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

-NetworkAccessPolicy

A hálózati hozzáférési szabályzat határozza meg a hálózati hozzáférési szabályzatot. Lehetséges értékek: "AllowAll", "AllowPrivate", "DenyAll"

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

-OptimizedForFrequentAttach

A tulajdonság igaz értékre állítása javítja a gyakran (naponta több mint 5 alkalommal) használt adatlemezek megbízhatóságát és teljesítményét azáltal, hogy leválasztja az egyik virtuális gépről, és egy másikhoz csatlakozik. Ezt a tulajdonságot nem szabad olyan lemezekre beállítani, amelyek nincsenek leválasztva és gyakran csatolva, mivel a lemezek nem igazodnak a virtuális gép tartalék tartományához.

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

-OsType

Az operációs rendszer típusát adja meg.

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

-PerformancePlus

Állítsa ezt a jelzőt igaz értékre, hogy növelhesse az üzembe helyezett lemez teljesítménycélját, lásd itt a megfelelő teljesítménycélt. Ez a jelző csak a lemezlétrehozás idején állítható be, és az engedélyezés után nem tiltható le.

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

-PublicNetworkAccess

A lemez exportálásának szabályozására vonatkozó szabályzat.

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

-PurchasePlan

Megadja a lemez vásárlási tervét.

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

-SkuName

Megadja a tárfiók termékváltozatának nevét. Az elérhető értékek a következők: Standard_LRS, Premium_LRS, StandardSSD_LRS és UltraSSD_LRS, Premium_ZRS és StandardSSD_ZRS. UltraSSD_LRS csak a CreateOption paraméter Üres értékével használható.

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

-SourceResourceId

Megadja a forráserőforrás-azonosítót.

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

-SourceUri

Megadja a forrás Uri-t.

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

-StorageAccountId

Megadja a tárfiók azonosítóját.

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

-SupportsHibernation

Az ügyfelek beállíthatják a SupportsHibernation jelzőt a lemezen.

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

-Tag

Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

A lemez teljesítményszintje.

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

-UploadSizeInBytes

Megadja a feltöltés tartalmának méretét, beleértve a VHD-láblécet is, amikor a CreateOption feltöltésre kerül. Ennek az értéknek a 20972032 (a VHD láblécéhez 20 MiB + 512 bájt) és 35183298347520 bájtnak kell lennie (a VHD-lábléchez 32 TiB + 512 bájt).

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

-Zone

A Lemez logikai zónalistáját adja meg.

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

Bevitelek

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

Kimenetek

PSDisk