Leer en inglés

Compartir a través de

Set-AzSqlDatabaseBackupLongTermRetentionPolicy

  • Referencia
Módulo:
Az.Sql

Establece una directiva de retención a largo plazo del servidor.

Sintaxis

PowerShell 
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
   -WeeklyRetention <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
   [-RemovePolicy]
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
   [-WeeklyRetention <String>]
   -MonthlyRetention <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
Set-AzSqlDatabaseBackupLongTermRetentionPolicy
   [-WeeklyRetention <String>]
   [-MonthlyRetention <String>]
   -YearlyRetention <String>
   -WeekOfYear <Int32>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzSqlDatabaseBackupLongTermRetentionPolicy establece la directiva de retención a largo plazo registrada en esta base de datos. La directiva es un recurso de Azure Backup que se usa para definir la directiva de almacenamiento de copia de seguridad.

Ejemplos

Ejemplo 1: Establecimiento de la retención semanal para la versión actual de la directiva de retención a largo plazo

PowerShell 
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                               :

Esto establece la directiva de retención a largo plazo de database01 para guardar cada copia de seguridad completa semanal durante 2 semanas.

Ejemplo 2: Establecimiento de la retención mensual para la versión actual de la directiva de retención a largo plazo

PowerShell 
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                               :

Esto establece la directiva de retención a largo plazo de database01 para guardar la primera copia de seguridad completa de cada mes durante 5 años.

Ejemplo 3: Establecimiento de la retención anual para la versión actual de la directiva de retención a largo plazo

PowerShell 
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                               :

Esto establece la directiva de retención a largo plazo de database01 para guardar la copia de seguridad completa realizada en la 26ª semana del año durante 10 años.

Ejemplo 4: Establecimiento de cada retención para la versión actual de la directiva de retención a largo plazo

PowerShell 
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                               :

Esto establece la directiva de retención a largo plazo de database01 para guardar cada copia de seguridad completa durante 14 días, la primera copia de seguridad completa de cada mes durante 24 semanas y la copia de seguridad completa realizada en la 26ª semana del año durante 10 años.

Ejemplo 5: Eliminación de la directiva de retención a largo plazo

PowerShell 
Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -RemovePolicy

ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : PT0S
WeekOfYear                             : 0
Location                               :

Quita la directiva de database01 para que ya no guarde ninguna copia de seguridad de retención a largo plazo. Esto no afectará a las copias de seguridad que ya se han realizado

Ejemplo 6: Eliminación de la directiva de retención a largo plazo

PowerShell 
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                               :

Esta es otra forma de quitar la directiva para database01, por lo que ya no guarda ninguna copia de seguridad de retención a largo plazo. Esto no afectará a las copias de seguridad que ya se han realizado

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseName

Nombre de Azure SQL Database que se va a usar.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MonthlyRetention

Retención mensual. Si solo se pasa un número en lugar de una cadena ISO 8601, los días se asumen como unidades. Hay un mínimo de 7 días y un máximo de 10 años.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-RemovePolicy

Si se proporciona, se quitará la directiva de la base de datos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServerName

Nombre de Azure SQL Server en el que se encuentra la base de datos.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WeeklyRetention

Retención semanal. Si solo se pasa un número en lugar de una cadena ISO 8601, los días se asumen como unidades. Hay un mínimo de 7 días y un máximo de 10 años.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WeekOfYear

La semana del año, de 1 a 52, para ahorrar para la retención anual.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-YearlyRetention

Retención anual. Si solo se pasa un número en lugar de una cadena ISO 8601, los días se asumen como unidades. Hay un mínimo de 7 días y un máximo de 10 años.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

Salidas