Set-AzSqlDatabaseBackupLongTermRetentionPolicy

  • Référence
Module:
Az.Sql

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

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

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                               :

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                               :

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                               :

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

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

Supprime 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

Exemple 6 : 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                               :

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 demande une confirmation avant d’exécuter l’applet de commande.

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

-DatabaseName

Nom d’Azure SQL Database à utiliser.

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

-DefaultProfile

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

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

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

-RemovePolicy

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

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

-ResourceGroupName

Nom du groupe de ressources.

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

-ServerName

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

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

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

-WeekOfYear

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

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

Entrées

String

Int32

Sorties

AzureSqlDatabaseBackupLongTermRetentionPolicyModel