Partager via

Set-AzSqlDatabaseBackupLongTermRetentionPolicy

Module:
Az.Sql Module

Définit une stratégie de rétention à long terme du serveur.

Syntaxe

WeeklyRetentionRequired (Par défaut) 

Set-AzSqlDatabaseBackupLongTermRetentionPolicy
    [-ServerName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    -WeeklyRetention <String>
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemovePolicy 

Set-AzSqlDatabaseBackupLongTermRetentionPolicy
    [-ServerName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    [-RemovePolicy]
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

MonthlyRetentionRequired 

Set-AzSqlDatabaseBackupLongTermRetentionPolicy
    [-ServerName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    -MonthlyRetention <String>
    [-WeeklyRetention <String>]
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

YearlyRetentionRequired 

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

Description

L’applet de commande Set-AzSqlDatabaseBackupLongTermRetentionPolicy définit la stratégie de rétention à long terme inscrite dans cette base de données. La stratégie est une ressource Sauvegarde Azure utilisée pour définir la stratégie de stockage de sauvegarde.

Exemples

Exemple 1 : Définir la rétention hebdomadaire pour la version actuelle de la stratégie de rétention à long terme

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                               :
TimeBasedImmutability                  : Disabled
TimeBasedImmutabilityMode              : Unlocked

Cela définit la stratégie de rétention à long terme de database01 pour enregistrer chaque sauvegarde complète hebdomadaire pendant 2 semaines

Exemple 2 : Définir la rétention mensuelle pour la version actuelle de la stratégie de rétention à long terme

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                               :
TimeBasedImmutability                  : Disabled
TimeBasedImmutabilityMode              : Unlocked

Cela définit la stratégie de rétention à long terme de database01 pour enregistrer la première sauvegarde complète de chaque mois pendant 5 ans

Exemple 3 : Définir la rétention annuelle pour la version actuelle de la stratégie de rétention à long terme

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                               :
TimeBasedImmutability                  : Disabled
TimeBasedImmutabilityMode              : Unlocked

Cela définit la stratégie de rétention à long terme de database01 pour enregistrer la sauvegarde complète effectuée sur la 26e semaine de l’année pendant 10 ans

Exemple 4 : Définir la rétention annuelle pour la version actuelle de la stratégie de rétention à long terme avec une immuabilité basée sur le temps déverrouillée activée

Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -YearlyRetention P10Y -WeekOfYear 26 -TimeBasedImmutability Enabled

ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : P10Y
WeekOfYear                             : 26
Location                               :
TimeBasedImmutability                  : Enabled
TimeBasedImmutabilityMode              : Unlocked

Cela définit la stratégie de rétention à long terme de database01 pour enregistrer la sauvegarde complète effectuée sur la 26e semaine de l’année pendant 10 ans. En outre, les sauvegardes seront créées avec une stratégie d’immuabilité basée sur le temps déverrouillée. Ces sauvegardes peuvent ultérieurement avoir leur immuabilité verrouillée ou supprimée.

Exemple 5 : Définir la rétention annuelle pour la version actuelle de la stratégie de rétention à long terme avec une immuabilité limitée dans le temps verrouillée activée

Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -YearlyRetention P10Y -WeekOfYear 26 -TimeBasedImmutability Enabled -TimeBasedImmutabilityMode Locked

ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : P10Y
WeekOfYear                             : 26
Location                               :
TimeBasedImmutability                  : Enabled
TimeBasedImmutabilityMode              : Locked

Cela définit la stratégie de rétention à long terme de database01 pour enregistrer la sauvegarde complète effectuée sur la 26e semaine de l’année pendant 10 ans. En outre, les sauvegardes seront créées avec une stratégie d’immuabilité basée sur le temps verrouillée. Ces sauvegardes ne peuvent pas être supprimées manuellement et ne seront supprimées qu’à l’expiration.

Exemple 6 : Définir chaque rétention pour la version actuelle de la stratégie de rétention à long terme

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                               :
TimeBasedImmutability                  : Disabled
TimeBasedImmutabilityMode              : Unlocked

Cela définit la stratégie de rétention à long terme de database01 pour enregistrer chaque sauvegarde complète pendant 14 jours, la première sauvegarde complète de chaque mois pendant 24 semaines et la sauvegarde complète effectuée sur la 26e semaine de l’année pendant 10 ans

Exemple 7 : Supprimer la stratégie de rétention à long terme

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

ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : PT0S
WeekOfYear                             : 0
Location                               :
TimeBasedImmutability                  : Disabled
TimeBasedImmutabilityMode              : Unlocked

Supprime la stratégie pour database01 afin qu’elle n’enregistre plus les sauvegardes de rétention à long terme. Cela n’affecte pas les sauvegardes qui ont déjà été effectuées.

Exemple 8 : Supprimer la stratégie de rétention à long terme

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                               :
TimeBasedImmutability                  : Disabled
TimeBasedImmutabilityMode              : Unlocked

Il s’agit d’une autre façon de supprimer la stratégie pour database01 afin qu’elle n’enregistre plus les sauvegardes de rétention à long terme. Cela n’affectera pas les sauvegardes qui ont déjà été effectuées

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseName

Nom du Azure SQL Database à utiliser.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MonthlyRetention

Rétention mensuelle. Si un seul nombre est passé au lieu d’une chaîne ISO 8601, les jours sont supposés comme unités. Il y a au moins 7 jours et un maximum de 10 ans.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

MonthlyRetentionRequired
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-RemovePolicy

Si elle est fournie, la stratégie de la base de données est effacée.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

RemovePolicy
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ServerName

Nom d’Azure SQL Server la base de données se trouve.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TimeBasedImmutability

Lorsqu’il est défini, TimeBasedImmutability sera activé pour les sauvegardes futures.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Enabled, Disabled
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-TimeBasedImmutabilityMode

Paramètre du mode d’immuabilité basé sur le temps pour les sauvegardes ultérieures. Effective uniquement si TimeBasedImmutability est activé. La valeur peut être verrouillée ou déverrouillée. Attention : L’immuabilité de la sauvegarde LTR ne peut pas être supprimée si TimeBasedImmutabilityMode est verrouillé.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Unlocked, Locked
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WeeklyRetention

Rétention hebdomadaire. Si un seul nombre est passé au lieu d’une chaîne ISO 8601, les jours sont supposés comme unités. Il y a au moins 7 jours et un maximum de 10 ans.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

WeeklyRetentionRequired
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WeekOfYear

La semaine de l’année, de 1 à 52, pour économiser pour la rétention annuelle.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

YearlyRetentionRequired
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-YearlyRetention

Rétention annuelle. Si un seul nombre est passé au lieu d’une chaîne ISO 8601, les jours sont supposés comme unités. Il y a au moins 7 jours et un maximum de 10 ans.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

YearlyRetentionRequired
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Int32

Sorties

AzureSqlDatabaseBackupLongTermRetentionPolicyModel