Update-AzureRmSnapshot

Módulo:

AzureRM.Compute

Atualiza um instantâneo.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Update-AzureRmSnapshot
      [-ResourceGroupName] <String>
      [-SnapshotName] <String>
      [-SnapshotUpdate] <PSSnapshotUpdate>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmSnapshot
      [-ResourceGroupName] <String>
      [-SnapshotName] <String>
      [-Snapshot] <PSSnapshot>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-AzureRmSnapshot atualiza um instantâneo.

Exemplos

Exemplo 1

PS C:\> $snapshotupdateconfig = New-AzureRmSnapshotUpdateConfig -DiskSizeGB 10 -AccountType PremiumLRS -OsType Windows -CreateOption Empty -EncryptionSettingsEnabled $true;
PS C:\> $secretUrl = https://myvault.vault-int.azure-int.net/secrets/123/;
PS C:\> $secretId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault123';
PS C:\> $keyUrl = https://myvault.vault-int.azure-int.net/keys/456;
PS C:\> $keyId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault456';
PS C:\> $snapshotupdateconfig = Set-AzureRmSnapshotUpdateDiskEncryptionKey -SnapshotUpdate $snapshotupdateconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
PS C:\> $snapshotupdateconfig = Set-AzureRmSnapshotUpdateKeyEncryptionKey -SnapshotUpdate $snapshotupdateconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
PS C:\> Update-AzureRmSnapshot -ResourceGroupName 'ResourceGroup01' -SnapshotName 'Snapshot01' -SnapshotUpdate $snapshotupdateconfig;

O primeiro comando cria um objeto de atualização de instantâneo vazio local com tamanho de 10 GB em Premium_LRS tipo de conta de armazenamento. Ele também define o tipo de sistema operacional Windows e habilita as configurações de criptografia. O segundo e o terceiro comandos definem as configurações da chave de criptografia de disco e da chave de criptografia de chave para o objeto de atualização de instantâneo. O último comando usa o objeto de atualização de instantâneo e atualiza um instantâneo existente com o nome 'Snapshot01' no grupo de recursos 'ResourceGroup01'.

Exemplo 2

PS C:\> New-AzureRmSnapshotUpdateConfig -DiskSizeGB 10 | Update-AzureRmSnapshot -ResourceGroupName 'ResourceGroup01' -SnapshotName 'Snapshot01';

Esse comando atualiza um instantâneo existente com o nome 'Snapshot01' no grupo de recursos 'ResourceGroup01' para o tamanho do disco de 10 GB.

Exemplo 3

PS C:\> $snapshot = Get-AzureRmSnapshot -ResourceGroupName 'ResourceGroup01' -SnapshotName 'Snapshot01';
PS C:\> $snapshot.DiskSizeGB = 10;
PS C:\> Update-AzureRmSnapshot -ResourceGroupName 'ResourceGroup01' -SnapshotName 'Snapshot01' -Snapshot $snapshot;

Esses comandos também atualizam um instantâneo existente com o nome 'Snapshot01' no grupo de recursos 'ResourceGroup01' para o tamanho do disco de 10 GB.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano e retorne um trabalho para acompanhar o progresso.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

Especifica o nome de um grupo de recursos.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Snapshot

Especifica um objeto de instantâneo local.

Tipo:	PSSnapshot
Cargo:	4
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SnapshotName

Especifica o nome de um instantâneo.

Tipo:	String
Aliases:	Name
Cargo:	2
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SnapshotUpdate

Especifica um objeto de atualização de instantâneo local.

Tipo:	PSSnapshotUpdate
Cargo:	3
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

String

PSSnapshotUpdate

Parâmetros: SnapshotUpdate (ByValue)

PSSnapshot

Parâmetros: Instantâneo (ByValue)

Saídas

PSSnapshot