Set-AzSqlDatabaseBackupLongTermRetentionPolicy
Define uma política de retenção de longo prazo do servidor.
Sintaxe
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
-WeeklyRetention <String>
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-RemovePolicy]
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-WeeklyRetention <String>]
-MonthlyRetention <String>
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-WeeklyRetention <String>]
[-MonthlyRetention <String>]
-YearlyRetention <String>
-WeekOfYear <Int32>
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-AzSqlDatabaseBackupLongTermRetentionPolicy define a política de retenção de longo prazo registrada nesse banco de dados. A política é um recurso do Backup do Azure usado para definir a política de armazenamento de backup.
Exemplos
Exemplo 1: Definir a retenção semanal para a versão atual da política de retenção de longo prazo
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -WeeklyRetention P2W
ResourceGroupName : resourcegroup01
ServerName : server01
DatabaseName : database01
WeeklyRetention : P2W
MonthlyRetention : PT0S
YearlyRetention : PT0S
WeekOfYear : 0
Location :
Isso define a política de retenção de longo prazo do database01 para salvar todos os backups completos semanais por 2 semanas
Exemplo 2: Definir a retenção mensal para a versão atual da política de retenção de longo prazo
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -MonthlyRetention P5Y
ResourceGroupName : resourcegroup01
ServerName : server01
DatabaseName : database01
WeeklyRetention : PT0S
MonthlyRetention : P5Y
YearlyRetention : PT0S
WeekOfYear : 0
Location :
Isso define a política de retenção de longo prazo do database01 para salvar o primeiro backup completo de cada mês por 5 anos
Exemplo 3: Definir a retenção anual para a versão atual da política de retenção de longo prazo
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -YearlyRetention P10Y -WeekOfYear 26
ResourceGroupName : resourcegroup01
ServerName : server01
DatabaseName : database01
WeeklyRetention : PT0S
MonthlyRetention : PT0S
YearlyRetention : P10Y
WeekOfYear : 26
Location :
Isso define a política de retenção de longo prazo do database01 para salvar o backup completo feito na 26ª semana do ano por 10 anos
Exemplo 4: Definir cada retenção para a versão atual da política de retenção de longo prazo
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -WeeklyRetention 14 -MonthlyRetention P24W -YearlyRetention P10Y -WeekOfYear 26
ResourceGroupName : resourcegroup01
ServerName : server01
DatabaseName : database01
WeeklyRetention : P14D
MonthlyRetention : P24W
YearlyRetention : P10Y
WeekOfYear : 26
Location :
Isso define a política de retenção de longo prazo do database01 para salvar cada backup completo por 14 dias, o primeiro backup completo de cada mês por 24 semanas e o backup completo feito na 26ª semana do ano por 10 anos
Exemplo 5: remover a política de retenção de longo prazo
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -RemovePolicy
ResourceGroupName : resourcegroup01
ServerName : server01
DatabaseName : database01
WeeklyRetention : PT0S
MonthlyRetention : PT0S
YearlyRetention : PT0S
WeekOfYear : 0
Location :
Remove a política do database01 para que ele não salve mais nenhum backup de retenção de longo prazo. Isso não afetará os backups que já foram feitos
Exemplo 6: remover a política de retenção de longo prazo
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -WeeklyRetention P0D
ResourceGroupName : resourcegroup01
ServerName : server01
DatabaseName : database01
WeeklyRetention : PT0S
MonthlyRetention : PT0S
YearlyRetention : PT0S
WeekOfYear : 0
Location :
Essa é outra maneira de remover a política do database01 para que ela não salve mais nenhum backup de retenção de longo prazo. Isso não afetará os backups que já foram feitos
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DatabaseName
O nome do Banco de Dados SQL do Azure a ser usado.
Tipo: | String |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MonthlyRetention
A retenção mensal. Se apenas um número for passado em vez de uma string ISO 8601, os dias serão assumidos como as unidades. Há um mínimo de 7 dias e um máximo de 10 anos.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-RemovePolicy
Se fornecida, a política do banco de dados será removida.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ResourceGroupName
O nome do grupo de recursos.
Tipo: | String |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ServerName
O nome do SQL Server do Azure em que o banco de dados está.
Tipo: | String |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-WeeklyRetention
A retenção semanal. Se apenas um número for passado em vez de uma string ISO 8601, os dias serão assumidos como as unidades. Há um mínimo de 7 dias e um máximo de 10 anos.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-WeekOfYear
A semana do ano, de 1 a 52, para economizar para a retenção anual.
Tipo: | Int32 |
Cargo: | Named |
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: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-YearlyRetention
A retenção anual. Se apenas um número for passado em vez de uma string ISO 8601, os dias serão assumidos como as unidades. Há um mínimo de 7 dias e um máximo de 10 anos.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Entradas
Saídas
AzureSqlDatabaseBackupLongTermRetentionPolicyModel