New-AzSnapshotConfig
Crea un objeto de instantánea configurable.
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>]
[-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] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Architecture
Arquitectura de CPU compatible con un disco del sistema operativo. Los valores posibles son "X64" y "Arm64".
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DataAccessAuthMode
Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskAccessId
Obtiene o establece el identificador de ARM del recurso DiskAccess en el que se usan puntos de conexión privados.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionKey
Especifica el objeto de clave de cifrado de disco en una instantánea.
Tipo: | KeyVaultAndSecretReference |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskSizeGB
Especifica el tamaño del disco en GB.
Tipo: | Int32 |
Position: | 2 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionSettingsEnabled
Habilite la configuración de cifrado.
Tipo: | Nullable<T>[Boolean] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionType
Tipo de clave que se usa para cifrar los datos del disco. Los valores disponibles son: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageReference
Especifica la referencia de imagen en una instantánea.
Tipo: | ImageDiskReference |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyEncryptionKey
Especifica la clave de cifrado de claves en una instantánea.
Tipo: | KeyVaultAndKeyReference |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Especifica una ubicación.
Tipo: | String |
Position: | 3 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OsType
Especifica el tipo de sistema operativo.
Tipo: | Nullable<T>[OperatingSystemTypes] |
valores aceptados: | Windows, Linux |
Position: | 1 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicNetworkAccess
Directiva para controlar la exportación en el disco.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkuName
Especifica el nombre de SKU de la cuenta de almacenamiento.
Tipo: | String |
Aliases: | AccountType |
Position: | 0 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceResourceId
Especifica el identificador de recurso de origen.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceUri
Especifica el URI de origen.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountId
Especifica el identificador de la cuenta de almacenamiento.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SupportsHibernation
Indica si el sistema operativo de la instantánea admite la hibernación con $true o $false
Tipo: | Nullable<T>[Boolean] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}
Tipo: | Hashtable |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Salidas
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de