New-AzSnapshotConfig

Referentie

Module:: Az.Compute

Hiermee maakt u een configureerbaar momentopnameobject.

Syntaxis

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

Met de cmdlet New-AzSnapshotConfig wordt een configureerbaar momentopnameobject gemaakt.

Voorbeelden

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

Met de eerste opdracht maakt u een lokaal leeg momentopnameobject met de grootte 5 GB in Standard_LRS opslagaccounttype. Ook wordt het type Windows-besturingssysteem ingesteld en worden versleutelingsinstellingen ingeschakeld. Met de tweede en derde opdrachten worden de instellingen voor schijfversleutelingssleutel en sleutelversleutelingssleutel voor het momentopnameobject ingesteld. De laatste opdracht maakt het momentopnameobject en maakt een momentopname met de naam Snapshot01 in de resourcegroep ResourceGroup01.

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

Met de eerste opdracht maakt u een lokaal leeg momentopnameobject met een resource-id voor de momentopname van ElasticSan Volume, met CreateOption als CopyFromSanSnapshot. De tweede opdracht maakt het momentopnameobject en maakt een momentopname met de naam Snapshot01 in de resourcegroep ResourceGroup01.

Voorbeeld 3

Hiermee maakt u een configureerbaar momentopnameobject. (automatisch gegenereerd)

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

Parameters

-AcceleratedNetwork

Is waar als de installatiekopieën van waaruit de besturingssysteemschijf wordt gemaakt, ondersteuning bieden voor versneld netwerken.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Architecture

CPU-architectuur die wordt ondersteund door een besturingssysteemschijf. Mogelijke waarden zijn X64 en Arm64.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CreateOption

Hiermee geeft u op of met deze cmdlet een schijf in de virtuele machine wordt gemaakt op basis van een platform- of gebruikersinstallatiekopieën, een lege schijf wordt gemaakt of een bestaande schijf wordt gekoppeld.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DataAccessAuthMode

Aanvullende verificatievereisten bij het exporteren of uploaden naar een schijf of momentopname.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DiskAccessId

Hiermee haalt u de ARM-id van de DiskAccess-resource op voor het gebruik van privé-eindpunten op.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DiskEncryptionKey

Hiermee geeft u het sleutelobject voor schijfversleuteling op een momentopname.

Type:	KeyVaultAndSecretReference
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DiskEncryptionSetId

Hiermee geeft u de resource-id op van de schijfversleuteling die moet worden gebruikt voor het inschakelen van versleuteling at rest.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DiskSizeGB

Hiermee geeft u de grootte van de schijf in GB.

Type:	Int32
Position:	2
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EdgeZone

Hiermee stelt u de naam van de randzone in. Als deze optie is ingesteld, wordt de query doorgestuurd naar de opgegeven edgezone in plaats van de hoofdregio.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ElasticSanResourceId

Vereist als createOption CopyFromSanSnapshot is. Dit is de ARM-id van de momentopname van het elastische san-volume van de bron.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EncryptionSettingsEnabled

Schakel versleutelingsinstellingen in.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EncryptionType

Het type sleutel dat wordt gebruikt om de gegevens van de schijf te versleutelen. Beschikbare waarden zijn: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-HyperVGeneration

De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven. Toegestane waarden zijn V1 en V2.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ImageReference

Hiermee geeft u de afbeeldingsreferentie op een momentopname.

Type:	ImageDiskReference
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Incremental

Hiermee geeft u een incrementele momentopname op. Incrementele momentopnamen op dezelfde schijf nemen minder ruimte in beslag dan volledige momentopnamen en kunnen worden gesynchroniseerd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-KeyEncryptionKey

Hiermee geeft u de sleutelversleutelingssleutel op een momentopname.

Type:	KeyVaultAndKeyReference
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Location

Hiermee geeft u een locatie.

Type:	String
Position:	3
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-NetworkAccessPolicy

Netwerktoegangsbeleid definieert het netwerktoegangsbeleid. Mogelijke waarden zijn: 'AllowAll', 'AllowPrivate', 'DenyAll'

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-OsType

Hiermee geeft u het type besturingssysteem.

Type:	Nullable<T>[OperatingSystemTypes]
Geaccepteerde waarden:	Windows, Linux
Position:	1
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PublicNetworkAccess

Beleid voor het beheren van export op de schijf.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PurchasePlan

Hiermee stelt u het aankoopplan voor de momentopname in. Wordt gebruikt voor het tot stand brengen van de aankoopcontext van een artefact van derden via Marketplace.

Type:	PSPurchasePlan
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SkuName

Hiermee geeft u de SKU-naam van het opslagaccount.

Type:	String
Aliassen:	AccountType
Position:	0
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SourceResourceId

Hiermee geeft u de bronresource-id op.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SourceUri

Hiermee geeft u de bron-URI.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-StorageAccountId

Hiermee geeft u de opslagaccount-id op.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SupportsHibernation

Geeft aan of het besturingssysteem op de momentopname de sluimerstand ondersteunt met $true of $false

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-TierOption

Wanneer createOption CopyStart wordt gemaakt, wordt de momentopname sneller gekopieerd. Mogelijke waarden zijn: 'None', 'Enhanced'

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

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

Uitvoerwaarden

PSSnapshot

Delen via