New-AzSnapshotConfig

參考

模組:: Az.Compute

建立可設定的快照集物件。

語法

New-AzSnapshotConfig
   [[-SkuName] <String>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [-HyperVGeneration <String>]
   [-Incremental]
   [-Tag <Hashtable>]
   [-CreateOption <String>]
   [-StorageAccountId <String>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-ImageReference <ImageDiskReference>]
   [-SourceUri <String>]
   [-SourceResourceId <String>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-DiskAccessId <String>]
   [-NetworkAccessPolicy <String>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-ElasticSanResourceId <String>]
   [-TierOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzSnapshotConfig Cmdlet 會建立可設定的快照集物件。

範例

範例 1

$snapshotconfig = New-AzSnapshotConfig -Location 'Central US' -DiskSizeGB 5 -AccountType StandardLRS -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';
$snapshotconfig = Set-AzSnapshotDiskEncryptionKey -Snapshot $snapshotconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$snapshotconfig = Set-AzSnapshotKeyEncryptionKey -Snapshot $snapshotconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
New-AzSnapshot -ResourceGroupName 'ResourceGroup01' -SnapshotName 'Snapshot01' -Snapshot $snapshotconfig;

第一個命令會在 Standard_LRS記憶體帳戶類型中建立大小為 5GB 的本機空白快照集物件。它也會設定 Windows OS 類型，並啟用加密設定。第二個和第三個命令會設定快照集物件的磁碟加密密鑰和金鑰加密金鑰設定。最後一個命令會擷取快照集物件，並在資源群組『ResourceGroup01』中建立名稱為『Snapshot01』的快照集。

範例 2

$elasticSanVolumeSnapshotResourceId =  "/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.ElasticSan/elasticSans/san1/volumeGroups/volumegroup1/snapshots/snapshot1"
$snapshotconfig = New-AzSnapshotConfig -Location 'France Central' -AccountType Standard_LRS -CreateOption CopyFromSanSnapshot -ElasticSanResourceId $elasticSanVolumeSnapshotResourceId
New-AzSnapshot -ResourceGroupName 'ResourceGroup01' -SnapshotName 'Snapshot01' -Snapshot $snapshotconfig;

第一個命令會建立具有 ElasticSan 磁碟區快照集資源標識符的本機空白快照集物件，並將 CreateOption 作為 CopyFromSanSnapshot。第二個命令會擷取快照集物件，並在資源群組『ResourceGroup01』中建立名稱為『Snapshot01』的快照集。

範例 3

建立可設定的快照集物件。（自動產生）

New-AzSnapshotConfig -CreateOption Empty -Location 'Central US' -SourceUri 'https://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd'

參數

-AcceleratedNetwork

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

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

-Architecture

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

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

-Confirm

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

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

-CreateOption

指定此 Cmdlet 是否從平台或使用者映像在虛擬機中建立磁碟、建立空白磁碟，或連接現有的磁碟。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	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

-DiskSizeGB

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

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

-EdgeZone

設定邊緣區域名稱。如果設定，查詢將會路由至指定的邊緣區域，而不是主要區域。

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

-ElasticSanResourceId

如果 createOption 是 CopyFromSanSnapshot，則為必要專案。這是來源彈性 san 磁碟區快照集的 ARM 識別碼。

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

-EncryptionSettingsEnabled

啟用加密設定。

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

-EncryptionType

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

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

-HyperVGeneration

虛擬機的 Hypervisor 產生。僅適用於OS磁碟。允許的值為 V1 和 V2。

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

-ImageReference

指定快照集上的映像參考。

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

-Incremental

指定增量快照集。相同磁碟上的累加快照集佔用的空間小於完整快照集，而且可能會有差異。

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

-KeyEncryptionKey

指定快照集上的金鑰加密金鑰。

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

-Location

指定位置。

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

-NetworkAccessPolicy

網路存取原則會定義網路存取原則。可能的值包括：'AllowAll'、'AllowPrivate'、'DenyAll'

類型:	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 名稱。

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

-SourceResourceId

指定來源資源識別碼。

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

-SourceUri

指定來源 URI。

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

-StorageAccountId

指定記憶體帳戶標識碼。

類型:	String
Position:	Named
預設值:	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:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-TierOption

當 createOption CopyStart 時，快照集會以更快的速度複製。可能的值包括：'None'、'Enhanced'

類型:	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

ImageDiskReference

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

KeyVaultAndSecretReference

KeyVaultAndKeyReference

輸出

PSSnapshot

共用方式為