Partilhar via

New-AzureRmVMSqlServerAutoBackupConfig

  • Referência
Módulo:
AzureRM.Compute

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

Aviso

O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação 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 URI de armazenamento e chave de conta

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

Este 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 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 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

Este 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 permite a criptografia com senha. A senha foi previamente armazenada como uma cadeia de caracteres 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 aceites:Manual, Automated
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-BackupSystemDbs

Realizar cópia de segurança das bases de dados do sistema

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-CertificatePassword

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

Tipo:SecureString
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 esse cronograma.

Tipo:SwitchParameter
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EnableEncryption

Indica que esse cmdlet habilita a criptografia.

Tipo:SwitchParameter
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FullBackupFrequency

Frequência do Backup Completo do Sql Server, diária ou semanal

Tipo:String
Valores aceites:Daily, Weekly
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FullBackupStartHour

Hora do dia (0-23) quando o Backup Completo do Sql Server deve ser iniciado

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-FullBackupWindowInHours

Janela Backup completo do SQL Server em horas

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LogBackupFrequencyInMinutes

Frequência do Backup de Log do SQL Server, uma vez a cada 1-60 minutos

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RetentionPeriodInDays

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

Tipo:Int32
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageKey

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

Tipo:SecureString
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageUri

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

Tipo:Uri
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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