Auf Englisch lesen

Freigeben über

Set-AzSqlDatabaseBackupLongTermRetentionPolicy

  • Referenz
Modul:
Az.Sql

Legt eine langfristige Aufbewahrungsrichtlinie für den Server fest.

Syntax

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

Beschreibung

Mit dem Cmdlet Set-AzSqlDatabaseBackupLongTermRetentionPolicy wird die langfristige Aufbewahrungsrichtlinie festgelegt, die für diese Datenbank registriert ist. Die Richtlinie ist eine Azure Backup-Ressource, die zum Definieren der Sicherungsspeicherrichtlinie verwendet wird.

Beispiele

Beispiel 1: Festlegen der wöchentlichen Aufbewahrung für die aktuelle Version der langfristigen Aufbewahrungsrichtlinie

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                               :

Dadurch wird die langfristige Aufbewahrungsrichtlinie von Database01 so festgelegt, dass jede wöchentliche vollständige Sicherung für 2 Wochen gespeichert wird.

Beispiel 2: Festlegen der monatlichen Aufbewahrung für die aktuelle Version der langfristigen Aufbewahrungsrichtlinie

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                               :

Dadurch wird die langfristige Aufbewahrungsrichtlinie von Database01 so festgelegt, dass die erste vollständige Sicherung jedes Monats für 5 Jahre gespeichert wird.

Beispiel 3: Festlegen der jährlichen Aufbewahrung für die aktuelle Version der langfristigen Aufbewahrungsrichtlinie

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                               :

Dadurch wird die langfristige Aufbewahrungsrichtlinie für Datenbank01 festgelegt, um die vollständige Sicherung zu speichern, die für die 26. Woche des Jahres für 10 Jahre erstellt wurde.

Beispiel 4: Festlegen jeder Aufbewahrung für die aktuelle Version einer langfristigen Aufbewahrungsrichtlinie

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                               :

Dadurch wird die langfristige Aufbewahrungsrichtlinie von Database01 so festgelegt, dass jede vollständige Sicherung für 14 Tage, die erste vollständige Sicherung jedes Monats für 24 Wochen und die vollständige Sicherung für die 26. Woche des Jahres für 10 Jahre gespeichert wird.

Beispiel 5: Entfernen der langfristigen Aufbewahrungsrichtlinie

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                               :

Entfernt die Richtlinie für Datenbank01, sodass keine langfristigen Aufbewahrungssicherungen mehr gespeichert werden. Dies wirkt sich nicht auf Sicherungen aus, die bereits durchgeführt wurden

Beispiel 6: Entfernen der langfristigen Aufbewahrungsrichtlinie

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                               :

Dies ist eine weitere Möglichkeit, die Richtlinie für Datenbank01 zu entfernen, sodass keine langfristigen Aufbewahrungssicherungen mehr gespeichert werden. Dies wirkt sich nicht auf Sicherungen aus, die bereits durchgeführt wurden

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatabaseName

Der Name des zu verwendenden Azure SQL-Datenbank.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MonthlyRetention

Die monatliche Aufbewahrung. Wenn nur eine Zahl anstelle einer ISO 8601-Zeichenfolge übergeben wird, werden Tage als Einheiten angenommen. Es gibt mindestens 7 Tage und maximal 10 Jahre.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RemovePolicy

Wenn angegeben, wird die Richtlinie für die Datenbank entfernt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServerName

Der Name des Azure SQL Server, in dem sich die Datenbank befindet.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WeeklyRetention

Die wöchentliche Aufbewahrung. Wenn nur eine Zahl anstelle einer ISO 8601-Zeichenfolge übergeben wird, werden Tage als Einheiten angenommen. Es gibt mindestens 7 Tage und maximal 10 Jahre.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WeekOfYear

Die Woche des Jahres, 1 bis 52, um für die jährliche Aufbewahrung zu speichern.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-YearlyRetention

Die jährliche Aufbewahrung. Wenn nur eine Zahl anstelle einer ISO 8601-Zeichenfolge übergeben wird, werden Tage als Einheiten angenommen. Es gibt mindestens 7 Tage und maximal 10 Jahre.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben