New-AzSnapshotConfig
Crea un objeto de instantánea configurable.
Sintaxis
Default (valor predeterminado)
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
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. (autogenerated)
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.
Propiedades de parámetro
Tipo: Nullable<T> [ Boolean ]
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-Architecture
Arquitectura de CPU compatible con un disco del sistema operativo. Los valores posibles son "X64" y "Arm64".
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: cf
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DataAccessAuthMode
Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-DiskAccessId
Obtiene o establece el identificador de ARM del recurso DiskAccess en el que se usan puntos de conexión privados.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DiskEncryptionKey
Especifica el objeto de clave de cifrado de disco en una instantánea.
Propiedades de parámetro
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DiskEncryptionSetId
Especifica el identificador de recurso del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DiskSizeGB
Especifica el tamaño del disco en GB.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 2
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-ElasticSanResourceId
Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador de ARM de la instantánea de volumen elástica de origen san.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-EncryptionSettingsEnabled
Habilite la configuración de cifrado.
Propiedades de parámetro
Tipo: Nullable<T> [ Boolean ]
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-EncryptionType
Tipo de clave que se usa para cifrar los datos del disco. Los valores disponibles son: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-ImageReference
Especifica la referencia de imagen en una instantánea.
Propiedades de parámetro
Tipo: ImageDiskReference
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-InstantAccessDurationMinutes
En el caso de las instantáneas creadas a partir de un disco Premium SSD v2 o Ultra, esta propiedad determina el tiempo en minutos que se conserva la instantánea para el acceso instantáneo a fin de permitir una restauración más rápida.
Propiedades de parámetro
Tipo: Int32
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-KeyEncryptionKey
Especifica la clave de cifrado de claves en una instantánea.
Propiedades de parámetro
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-Location
Especifica una ubicación.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 3
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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'
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-OsType
Especifica el tipo de sistema operativo.
Propiedades de parámetro
Conjuntos de parámetros
(All)
Posición: 1
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-PublicNetworkAccess
Directiva para controlar la exportación en el disco.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: PSPurchasePlan
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-SkuName
Especifica el nombre de SKU de la cuenta de almacenamiento.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: TipoDeCuenta
Conjuntos de parámetros
(All)
Posición: 0
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-SourceResourceId
Especifica el identificador de recurso de origen.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-SourceUri
Especifica el URI de origen.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-StorageAccountId
Especifica el identificador de la cuenta de almacenamiento.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-SupportsHibernation
Indica si el sistema operativo de la instantánea admite la hibernación con $true o $false
Propiedades de parámetro
Tipo: Nullable<T> [ Boolean ]
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-Tag
Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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"
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: Wi
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas