New-AzDiskUpdateConfig

參考

模組:: Az.Compute

建立可設定的磁碟更新物件。

語法

New-AzDiskUpdateConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-NetworkAccessPolicy <String>]
   [-DiskAccessId <String>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Tag] <Hashtable>]
   [-DiskIOPSReadWrite <Int32>]
   [-DiskMBpsReadWrite <Int32>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzDiskUpdateConfig Cmdlet 會建立可設定的磁碟更新物件。

範例

範例 1

$diskupdateconfig = New-AzDiskUpdateConfig -DiskSizeGB 10 -SkuName Premium_LRS -OsType Windows -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';
$diskupdateconfig = Set-AzDiskUpdateDiskEncryptionKey -DiskUpdate $diskupdateconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskupdateconfig = Set-AzDiskUpdateKeyEncryptionKey -DiskUpdate $diskupdateconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
Update-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DiskUpdate $diskupdateconfig;

第一個命令會在 Premium_LRS記憶體帳戶類型中建立大小為 10GB 的本機空白磁碟更新物件。它也會設定 Windows OS 類型，並啟用加密設定。第二和第三個命令會設定磁碟更新物件的磁碟加密密鑰和金鑰加密金鑰設定。最後一個命令會採用磁碟更新物件，並在資源群組『ResourceGroup01』中更新名稱為『Disk01』的現有磁碟。

範例 2

New-AzDiskUpdateConfig -DiskSizeGB 10 | Update-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01';

此命令會將資源群組『ResourceGroup01』中名稱為『Disk01』的現有磁碟更新為 10 GB 磁碟大小。

參數

-AcceleratedNetwork

如果建立OS磁碟的映像支援加速網路，則為True。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Architecture

OS 磁碟支援的CPU架構。可能的值為「X64」和「Arm64」。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-BurstingEnabled

啟用超出磁碟布建效能目標的高載。預設會停用高載。不適用於 Ultra 磁碟。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DataAccessAuthMode

匯出或上傳至磁碟或快照集時的其他驗證需求。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DiskAccessId

DiskAccess 資源的 ARM 識別碼，用於在磁碟上使用私人端點

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskEncryptionKey

指定磁碟上的磁碟加密密鑰物件。

類型:	KeyVaultAndSecretReference
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskEncryptionSetId

指定要用於啟用待用加密的磁碟加密集資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskIOPSReadOnly

所有裝載共用磁碟作為 ReadOnly 的 VM 所允許的 IOPS 總數。一個作業可以在 4k 到 256k 個字節之間傳輸。

類型:	Nullable<T>[Int64]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskIOPSReadWrite

此磁碟允許的 IOPS 數目;只能針對 UltraSSD 磁碟設定。一個作業可以在 4k 到 256k 個字節之間傳輸。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskMBpsReadOnly

所有裝載共用磁碟作為 ReadOnly 的 VM 所允許的總輸送量（MBps）。 MBps 表示每秒數百萬個字節 - MB 會使用 ISO 表示法，其乘冪為 10。

類型:	Nullable<T>[Int64]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskMBpsReadWrite

此磁碟允許的頻寬;只能針對 UltraSSD 磁碟設定。 MBps 表示每秒數百萬個字節 - MB 會使用 ISO 表示法，其乘冪為 10。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DiskSizeGB

指定以 GB 為單位的磁碟大小。

類型:	Int32
Position:	2
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EncryptionSettingsEnabled

在磁碟上啟用加密設定

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-EncryptionType

用來加密磁碟數據的金鑰類型。可用的值為：EncryptionAtRestWithPlatformKey、EncryptionAtRestWithCustomerKey

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-KeyEncryptionKey

指定磁碟上的金鑰加密金鑰。

類型:	KeyVaultAndKeyReference
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-MaxSharesCount

可以同時連結至磁碟的 VM 數目上限。大於一個值表示可以同時掛接在多個 VM 上的磁碟。

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-NetworkAccessPolicy

透過網路存取磁碟的原則。可用的值為：AllowAll、AllowPrivate、DeyAll

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-OsType

指定 OS 類型。

類型:	Nullable<T>[OperatingSystemTypes]
接受的值:	Windows, Linux
Position:	1
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-PublicNetworkAccess

控制磁碟上導出的原則。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-PurchasePlan

設定磁碟的購買方案。用於透過 Marketplace 建立第三方成品的購買內容。

類型:	PSPurchasePlan
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SkuName

指定記憶體帳戶的 SKU 名稱。可用的值為Standard_LRS、Premium_LRS、StandardSSD_LRS和UltraSSD_LRS。 UltraSSD_LRS只能與 CreateOption 參數的 Empty 值搭配使用。

類型:	String
別名:	AccountType
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SupportsHibernation

指出磁碟上的 OS 是否支援使用$true或$false休眠

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Tag

哈希表形式的索引鍵/值組。例如：@{key0=“value0”;key1=$null;key2=“value2”}

類型:	Hashtable
Position:	3
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Tier

磁碟的效能層級。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

Hashtable

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

KeyVaultAndSecretReference

KeyVaultAndKeyReference

輸出

PSDiskUpdate

共用方式為