Set-AzSqlDatabaseBackupLongTermRetentionPolicy

  • Referencia
Módulo:
Az.Sql

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

Syntax

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

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

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

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

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

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

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

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 solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Nombre de Azure SQL Database que se va a usar.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RemovePolicy

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nombre del grupo de recursos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WeekOfYear

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Int32

Salidas

AzureSqlDatabaseBackupLongTermRetentionPolicyModel