New-AzSnapshotConfig

構成可能なスナップショット オブジェクトを作成します。

構文

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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzSnapshotConfig コマンドレットは、構成可能なスナップショット オブジェクトを作成します。

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

最初のコマンドでは、ストレージ アカウントの種類でサイズが 5 GB のローカルの空のスナップショット オブジェクトStandard_LRS作成します。 また、Windows OS の種類を設定し、暗号化設定を有効にします。 2 番目と 3 番目のコマンドは、スナップショット オブジェクトのディスク暗号化キーとキー暗号化キーの設定を設定します。 最後のコマンドは、スナップショット オブジェクトを取得し、リソース グループ 'ResourceGroup01' に 'Snapshot01' という名前のスナップショットを作成します。

例 2

構成可能なスナップショット オブジェクトを作成します。 (自動生成)

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

パラメーター

-AcceleratedNetwork

OS ディスクの作成元のイメージが高速ネットワークをサポートしている場合は True。

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

OS ディスクでサポートされる CPU アーキテクチャ。 指定できる値は、"X64" と "Arm64" です。

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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

このコマンドレットで、プラットフォームまたはユーザー イメージから仮想マシンにディスクを作成するか、空のディスクを作成するか、既存のディスクを接続するかを指定します。

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

ディスクまたはスナップショットにエクスポートまたはアップロードするときの追加の認証要件。

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

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

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

プライベート エンドポイントを使用するための DiskAccess リソースの ARM ID を取得または設定します。

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

スナップショット上のディスク暗号化キー オブジェクトを指定します。

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

保存時の暗号化を有効にするために使用するディスク暗号化セットのリソース ID を指定します。

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

ディスクのサイズを GB 単位で指定します。

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

エッジ ゾーン名を設定します。 設定すると、クエリはメインリージョンではなく、指定されたエッジゾーンにルーティングされます。

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

暗号化設定を有効にします。

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

ディスクのデータを暗号化するために使用されるキーの種類。 使用可能な値: 'EncryptionAtRestWithPlatformKey'、'EncryptionAtRestWithCustomerKey'

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

仮想マシンのハイパーバイザー生成。 OS ディスクにのみ適用されます。 使用できる値は V1 と V2 です。

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

スナップショットのイメージ参照を指定します。

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

増分スナップショットを指定します。 同じディスク上の増分スナップショットは、完全なスナップショットよりも少ない領域を占有し、差分できます。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-KeyEncryptionKey

スナップショットのキー暗号化キーを指定します。

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

場所を指定します。

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

ネットワーク アクセス ポリシーは、ネットワーク アクセス ポリシーを定義します。 使用可能な値は、'AllowAll'、'AllowPrivate'、'DenyAll' です。

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

OS の種類を指定します。

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

ディスク上のエクスポートを制御するためのポリシー。

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

{{ PurchasePlan の説明を入力 }}

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

ストレージ アカウントの SKU 名を指定します。

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

ソース リソース ID を指定します。

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

ソース URI を指定します。

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

ストレージ アカウント ID を指定します。

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

{{ Fill SupportsHibernation Description }}

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

ハッシュ テーブルの形式のキーと値のペア。 例: @{key0="value0";key1=$null;key2="value2"}

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
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

Hashtable

ImageDiskReference

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

KeyVaultAndSecretReference

KeyVaultAndKeyReference

出力

PSSnapshot