New-AzSnapshotConfig

Referentie

Module:: Az.Compute

Hiermee maakt u een configureerbaar momentopnameobject.

Syntax

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>]
   [-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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Architecture

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DataAccessAuthMode

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

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskEncryptionKey

Hiermee geeft u het sleutelobject voor schijfversleuteling op een momentopname.

Type:	KeyVaultAndSecretReference
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskSizeGB

Hiermee geeft u de grootte van de schijf in GB.

Type:	Int32
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EncryptionSettingsEnabled

Schakel versleutelingsinstellingen in.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ImageReference

Hiermee geeft u de afbeeldingsreferentie op een momentopname.

Type:	ImageDiskReference
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyEncryptionKey

Hiermee geeft u de sleutelversleutelingssleutel op een momentopname.

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

-Location

Hiermee geeft u een locatie.

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

-NetworkAccessPolicy

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

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

-OsType

Hiermee geeft u het type besturingssysteem.

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

-PublicNetworkAccess

Beleid voor het beheren van export op de schijf.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SkuName

Hiermee geeft u de SKU-naam van het opslagaccount.

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

-SourceResourceId

Hiermee geeft u de bronresource-id op.

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

-SourceUri

Hiermee geeft u de bron-URI.

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

-StorageAccountId

Hiermee geeft u de opslagaccount-id op.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

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