Compartilhar via

New-AzureRmVMSqlServerAutoBackupConfig

  • Referência
Módulo:
AzureRM.Compute

Cria um objeto de configuração para o backup automático do SQL Server.

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

New-AzureRmVMSqlServerAutoBackupConfig
   [-ResourceGroupName] <String>
   [-Enable]
   [[-RetentionPeriodInDays] <Int32>]
   [-EnableEncryption]
   [[-CertificatePassword] <SecureString>]
   [[-StorageUri] <Uri>]
   [[-StorageKey] <SecureString>]
   [-BackupSystemDbs]
   [-BackupScheduleType <String>]
   [-FullBackupFrequency <String>]
   [-FullBackupStartHour <Int32>]
   [-FullBackupWindowInHours <Int32>]
   [-LogBackupFrequencyInMinutes <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmVMSqlServerAutoBackupConfig
   [-ResourceGroupName] <String>
   [-Enable]
   [[-RetentionPeriodInDays] <Int32>]
   [-EnableEncryption]
   [[-CertificatePassword] <SecureString>]
   [[-StorageContext] <IStorageContext>]
   [[-StorageUri] <Uri>]
   [[-StorageKey] <SecureString>]
   [-BackupSystemDbs]
   [-BackupScheduleType <String>]
   [-FullBackupFrequency <String>]
   [-FullBackupStartHour <Int32>]
   [-FullBackupWindowInHours <Int32>]
   [-LogBackupFrequencyInMinutes <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzureRmVMSqlServerAutoBackupConfig cria um objeto de configuração para o backup automático do SQL Server.

Exemplos

Exemplo 1: Criar uma configuração de backup automático usando o URI de armazenamento e a chave da conta

PS C:\> $AutoBackupConfig = New-AzureRmVMSqlServerAutoBackupConfig -Enable -RetentionPeriod 10 -StorageUri "\\contoso\StorageGeneral" -StorageKey "< Storage Key for ContosoGeneral >"
Enable                : True
EnableEncryption      : False
RetentionPeriodInDays : 10

Esse comando cria um objeto de configuração de backup automático especificando o URI de armazenamento e a chave da conta. O backup automático é ativado e os backups automáticos são mantidos por 10 dias. O comando armazena o resultado na variável $AutoBackupConfig. Você pode especificar esse item de configuração para outros cmdlets, como o cmdlet Set-AzureRmVMSqlServerExtension.

Exemplo 2: Criar uma configuração de backup automático usando o contexto de armazenamento

PS C:\> $StorageContext = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral >"
PS C:\> $AutoBackupConfig = New-AzureRmVMSqlServerAutoBackupConfig -StorageContext $StorageContext -Enable -RetentionPeriod 10
Enable                : True
EnableEncryption      : False
RetentionPeriodInDays : 10

O primeiro comando cria um contexto de armazenamento e, em seguida, armazena-o na variável $StorageContext. Para obter mais informações, consulte New-AzureStorageContext. O segundo comando cria um objeto de configuração de backup automático especificando o contexto de armazenamento em $StorageContext. O backup automático é ativado e os backups automáticos são mantidos por 10 dias.

Exemplo 3: Criar uma configuração de backup automático usando o contexto de armazenamento com criptografia e senha

PS C:\> $StorageContext = New-AzureRmVMSqlServerAutoBackupConfig -StorageContext $StorageContext -Enable -RetentionPeriod 10 -EnableEncryption -CertificatePassword $CertificatePassword
Enable                : True
EnableEncryption      : True
RetentionPeriodInDays : 10

Esse comando cria e armazena um objeto de configuração de backup automático. O comando especifica o contexto de armazenamento criado em um exemplo anterior. O comando habilita a criptografia com senha. A senha foi armazenada anteriormente como uma string segura na variável $CertificatePassword. Para criar uma cadeia de caracteres segura, use o cmdlet ConvertTo-SecureString.

Parâmetros

-BackupScheduleType

Tipo de agendamento de backup, manual ou automatizado

Tipo:String
Valores aceitos:Manual, Automated
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-BackupSystemDbs

Bancos de dados do sistema de backup

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

-CertificatePassword

Especifica uma senha para criptografar o certificado usado para executar backups criptografados do SQL Server.

Tipo:SecureString
Cargo:4
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

-Enable

Indica que o backup automatizado para a máquina virtual do SQL Server está habilitado. Se você especificar esse parâmetro, o backup automatizado definirá um agendamento de backup para todos os bancos de dados atuais e novos. Isso atualiza as configurações do Backup gerenciado para seguir essa programação.

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

-EnableEncryption

Indica que esse cmdlet habilita a criptografia.

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

-FullBackupFrequency

Frequência de backup completo do Sql Server, diária ou semanal

Tipo:String
Valores aceitos:Daily, Weekly
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-FullBackupStartHour

Hora do dia (0-23) em que o Backup Completo do SQL Server deve ser iniciado

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-FullBackupWindowInHours

Janela de backup completo do SQL Server em horas

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LogBackupFrequencyInMinutes

Frequência de backup de log do SQL Server, uma vez a cada 1 a 60 minutos

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

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

-RetentionPeriodInDays

Especifica o número de dias para manter um backup.

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

-StorageContext

Especifica a conta de armazenamento que será usada para armazenar backups. Para obter um objeto AzureStorageContext , use o cmdlet New-AzureStorageContext. O padrão é a conta de armazenamento associada à máquina virtual do SQL Server.

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

-StorageKey

Especifica a chave de armazenamento da conta de armazenamento de blobs.

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

-StorageUri

Especifica o URI (Uniform Resource Identifier) da conta de armazenamento de blobs.

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

Entradas

String

SwitchParameter

Int32

IStorageContext

Uri

SecureString

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Saídas

AutoBackupSettings