Set-AzSqlDatabaseBackupLongTermRetentionPolicy
Define uma política de retenção de longo prazo do servidor.
Sintaxe
WeeklyRetentionRequired (Predefinição)
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
-WeeklyRetention <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemovePolicy
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
[-RemovePolicy]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
MonthlyRetentionRequired
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
-MonthlyRetention <String>
[-WeeklyRetention <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
YearlyRetentionRequired
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
[-ServerName] <String>
[-DatabaseName] <String>
[-ResourceGroupName] <String>
-YearlyRetention <String>
-WeekOfYear <Int32>
[-WeeklyRetention <String>]
[-MonthlyRetention <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 de 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 cada backup completo semanal 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 para database01 para que ela não salve mais backups 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 banco de dados01 para que ele não salve mais backups de retenção de longo prazo.
Isso não afetará os backups que já foram feitos
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: False Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DatabaseName
O nome do Banco de Dados SQL do Azure a ser usado.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-MonthlyRetention
A retenção mensal.
Se apenas um número for passado em vez de uma cadeia de caracteres ISO 8601, os dias serão assumidos como as unidades.
Há um mínimo de 7 dias e um máximo de 10 anos.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
MonthlyRetentionRequired
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-RemovePolicy
Se fornecida, a política para o banco de dados será removida.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemovePolicy
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ServerName
O nome do SQL Server do Azure em que o banco de dados está.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WeeklyRetention
A retenção semanal.
Se apenas um número for passado em vez de uma cadeia de caracteres ISO 8601, os dias serão assumidos como as unidades.
Há um mínimo de 7 dias e um máximo de 10 anos.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
WeeklyRetentionRequired
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WeekOfYear
A Semana do Ano, 1 a 52, para poupar para a retenção anual.
Propriedades dos parâmetros
Tipo: Int32
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
YearlyRetentionRequired
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: False Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-YearlyRetention
A retenção anual.
Se apenas um número for passado em vez de uma cadeia de caracteres ISO 8601, os dias serão assumidos como as unidades.
Há um mínimo de 7 dias e um máximo de 10 anos.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
YearlyRetentionRequired
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
