共用方式為


New-AzSnapshotConfig

建立可配置的快照物件。

語法

Default (預設值)

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>]
    [-InstantAccessDurationMinutes <Int32>]
    [-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;

第一個命令會在儲存體帳戶類型中建立大小為 5GB 的本機空快照集物件Standard_LRS。 它還設置 Windows 操作系統類型並啟用加密設置。 第二個和第三個命令會設定快照物件的磁碟加密金鑰和金鑰加密金鑰設定。 最後一個命令會取得快照集物件,並在資源群組 '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 Volume 快照資源 ID 的本機空白快照物件,並將 CreateOption 作為 CopyFromSanSnapshot。 第二個命令會取得快照集物件,並在資源群組 'ResourceGroup01' 中建立名稱為 'Snapshot01' 的快照集。

範例 3

建立可配置的快照物件。 (autogenerated)

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

參數

-AcceleratedNetwork

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

參數屬性

類型:

Nullable<T>[Boolean]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Architecture

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Confirm

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參閱

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CreateOption

指定此 Cmdlet 是否要從平臺或使用者映像在虛擬機器中建立磁碟、建立空白磁碟,或附加現有的磁碟。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DataAccessAuthMode

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DefaultProfile

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

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DiskAccessId

取得或設定 DiskAccess 資源的 ARM 識別碼,以使用私人端點。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DiskEncryptionKey

指定快照集上的磁碟加密金鑰物件。

參數屬性

類型:KeyVaultAndSecretReference
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DiskEncryptionSetId

指定磁碟加密集的資源識別碼,以用於啟用靜態加密。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DiskSizeGB

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

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:2
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-EdgeZone

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ElasticSanResourceId

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-EncryptionSettingsEnabled

啟用加密設定。

參數屬性

類型:

Nullable<T>[Boolean]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-EncryptionType

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-HyperVGeneration

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ImageReference

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

參數屬性

類型:ImageDiskReference
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Incremental

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-InstantAccessDurationMinutes

對於從高級 SSD v2 或超級磁碟創建的快照,此屬性確定保留快照以供即時訪問以實現更快還原的時間(以分鐘為單位)。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-KeyEncryptionKey

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

參數屬性

類型:KeyVaultAndKeyReference
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Location

指定位置。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:3
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-NetworkAccessPolicy

網路存取原則定義網路存取原則。 可能的值包括: 'AllowAll', 'AllowPrivate', 'DenyAll'

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-OsType

指定作業系統類型。

參數屬性

類型:

Nullable<T>[OperatingSystemTypes]

預設值:None
接受的值:Windows, Linux
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-PublicNetworkAccess

控制磁碟上導出的原則。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-PurchasePlan

設定快照的購買計劃。 用於透過 Marketplace 建立任何第三方成品的購買內容。

參數屬性

類型:PSPurchasePlan
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SkuName

指定儲存體帳戶的 SKU 名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:帳戶類型

參數集

(All)
Position:0
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SourceResourceId

指定來源資源 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SourceUri

指定來源 Uri。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-StorageAccountId

指定儲存體帳戶識別碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SupportsHibernation

指出快照上的作業系統是否支援$true或$false休眠

參數屬性

類型:

Nullable<T>[Boolean]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Tag

雜湊表形式的鍵值對。 例如:@{key0=“value0”;key1=$null;key2=“值2”}

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-TierOption

當createOption CopyStart時,快照的複製速度會更快。 可能的值包括:「無」、「增強」

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康星州

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

String

Nullable<T>

Int32

Hashtable

ImageDiskReference

Nullable<T>

KeyVaultAndSecretReference

KeyVaultAndKeyReference

輸出

PSSnapshot