Compartir a través de

New-AzSnapshotConfig

  • Referencia
Módulo:
Az.Compute

Crea un objeto de instantánea configurable.

Sintaxis

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

El cmdlet New-AzSnapshotConfig crea un objeto de instantánea configurable.

Ejemplos

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

El primer comando crea un objeto de instantánea vacío local con un tamaño de 5 GB en Standard_LRS tipo de cuenta de almacenamiento. También establece el tipo de sistema operativo Windows y habilita la configuración de cifrado. Los comandos segundo y tercero establecen la clave de cifrado de disco y la configuración de la clave de cifrado de claves para el objeto de instantánea. El último comando toma el objeto de instantánea y crea una instantánea con el nombre "Snapshot01" en el grupo de recursos "ResourceGroup01".

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

El primer comando crea un objeto de instantánea vacío local con un identificador de recurso de instantánea de volumen de ElasticSan, con CreateOption como CopyFromSanSnapshot. El segundo comando toma el objeto de instantánea y crea una instantánea con el nombre "Snapshot01" en el grupo de recursos "ResourceGroup01".

Ejemplo 3

Crea un objeto de instantánea configurable. (generado automáticamente)

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

Parámetros

-AcceleratedNetwork

True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Architecture

Arquitectura de CPU compatible con un disco del sistema operativo. Los valores posibles son "X64" y "Arm64".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CreateOption

Especifica si este cmdlet crea un disco en la máquina virtual a partir de una plataforma o una imagen de usuario, crea un disco vacío o conecta un disco existente.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DataAccessAuthMode

Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DiskAccessId

Obtiene o establece el identificador de ARM del recurso DiskAccess en el que se usan puntos de conexión privados.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DiskEncryptionKey

Especifica el objeto de clave de cifrado de disco en una instantánea.

Tipo:KeyVaultAndSecretReference
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DiskEncryptionSetId

Especifica el identificador de recurso del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DiskSizeGB

Especifica el tamaño del disco en GB.

Tipo:Int32
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EdgeZone

Establece el nombre de la zona perimetral. Si se establece, la consulta se enrutará a la zona perimetral especificada en lugar de a la región principal.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ElasticSanResourceId

Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador de ARM de la instantánea de volumen elástica de origen san.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EncryptionSettingsEnabled

Habilite la configuración de cifrado.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EncryptionType

Tipo de clave que se usa para cifrar los datos del disco. Los valores disponibles son: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-HyperVGeneration

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. Los valores permitidos son V1 y V2.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ImageReference

Especifica la referencia de imagen en una instantánea.

Tipo:ImageDiskReference
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Incremental

Especifica una instantánea incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden diffed.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-KeyEncryptionKey

Especifica la clave de cifrado de claves en una instantánea.

Tipo:KeyVaultAndKeyReference
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Location

Especifica una ubicación.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NetworkAccessPolicy

La directiva de acceso de red define la directiva de acceso a la red. Entre los valores posibles se incluyen: 'AllowAll', 'AllowPrivate', 'DenyAll'

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-OsType

Especifica el tipo de sistema operativo.

Tipo:Nullable<T>[OperatingSystemTypes]
Valores aceptados:Windows, Linux
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PublicNetworkAccess

Directiva para controlar la exportación en el disco.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PurchasePlan

Establece el plan de compra de la instantánea. Se usa para establecer el contexto de compra de cualquier artefacto de terceros a través de Marketplace.

Tipo:PSPurchasePlan
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SkuName

Especifica el nombre de SKU de la cuenta de almacenamiento.

Tipo:String
Alias:AccountType
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SourceResourceId

Especifica el identificador de recurso de origen.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SourceUri

Especifica el URI de origen.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountId

Especifica el identificador de la cuenta de almacenamiento.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SupportsHibernation

Indica si el sistema operativo de la instantánea admite la hibernación con $true o $false

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TierOption

Al crearOption CopyStart, la instantánea se copiará a una velocidad más rápida. Entre los valores posibles se incluyen: "None", "Enhanced"

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

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

Salidas

PSSnapshot