Udostępnij przez

Set-AzSqlDatabaseBackupLongTermRetentionPolicy

Moduł:
Az.Sql Module

Ustawia zasady przechowywania długoterminowego serwera.

Składnia

WeeklyRetentionRequired (Domyślne) 

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

Opis

Polecenie cmdlet Set-AzSqlDatabaseBackupLongTermRetentionPolicy ustawia zasady przechowywania długoterminowego zarejestrowane w tej bazie danych. Zasady są zasobem usługi Azure Backup używanym do definiowania zasad magazynu kopii zapasowych.

Przykłady

Przykład 1. Ustawianie tygodniowego przechowywania dla bieżącej wersji zasad przechowywania długoterminowego

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

Spowoduje to ustawienie zasad przechowywania długoterminowego bazy danych database01 w celu zapisania co tydzień pełnej kopii zapasowej przez 2 tygodnie

Przykład 2. Ustawianie miesięcznego przechowywania dla bieżącej wersji zasad przechowywania długoterminowego

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

Spowoduje to ustawienie zasad przechowywania długoterminowego bazy danych database01 w celu zapisania pierwszej pełnej kopii zapasowej każdego miesiąca przez 5 lat

Przykład 3. Ustawianie przechowywania długoterminowego dla bieżącej wersji zasad przechowywania długoterminowego

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

Spowoduje to ustawienie zasad przechowywania długoterminowego bazy danych database01 w celu zapisania pełnej kopii zapasowej wykonanej w 26 tygodniu roku przez 10 lat

Przykład 4. Ustawianie przechowywania długoterminowego dla bieżącej wersji zasad przechowywania długoterminowego z włączonym niezmiennością na podstawie czasu odblokowanego

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

Spowoduje to ustawienie zasad przechowywania długoterminowego bazy danych database01 w celu zapisania pełnej kopii zapasowej wykonanej w 26 tygodniu roku przez 10 lat. Ponadto kopie zapasowe zostaną utworzone przy użyciu odblokowanych zasad niezmienności opartych na czasie. Te kopie zapasowe mogą później mieć zablokowaną lub usuniętą niezmienność.

Przykład 5: Ustawianie przechowywania długoterminowego dla bieżącej wersji zasad przechowywania długoterminowego z włączoną zablokowaną niezmiennością opartą na czasie

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

Spowoduje to ustawienie zasad przechowywania długoterminowego bazy danych database01 w celu zapisania pełnej kopii zapasowej wykonanej w 26 tygodniu roku przez 10 lat. Ponadto kopie zapasowe zostaną utworzone przy użyciu zablokowanych zasad niezmienności opartych na czasie. Te kopie zapasowe nie można usunąć ręcznie i zostaną usunięte tylko po wygaśnięciu.

Przykład 6. Ustawianie każdego przechowywania dla bieżącej wersji zasad przechowywania długoterminowego

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

Spowoduje to ustawienie zasad przechowywania długoterminowego bazy danych database01 w celu zapisania każdej pełnej kopii zapasowej przez 14 dni, pierwszej pełnej kopii zapasowej każdego miesiąca przez 24 tygodnie oraz pełnej kopii zapasowej wykonanej w 26 tygodniu roku przez 10 lat

Przykład 7. Usuwanie zasad przechowywania długoterminowego

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

Usuwa zasady dla bazy danych database01, więc nie zapisuje już żadnych kopii zapasowych przechowywania długoterminowego. Nie wpłynie to na kopie zapasowe, które zostały już wykonane.

Przykład 8. Usuwanie zasad przechowywania długoterminowego

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

Jest to inny sposób usuwania zasad dla bazy danych01, więc nie zapisuje już żadnych kopii zapasowych przechowywania długoterminowego. Nie wpłynie to na kopie zapasowe, które zostały już wykonane

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DatabaseName

Nazwa usługi Azure SQL Database do użycia.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:2
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-MonthlyRetention

Miesięczny okres przechowywania. Jeśli tylko liczba jest przekazywana zamiast ciągu ISO 8601, dni zostaną przyjęte jako jednostki. Istnieje co najmniej 7 dni i maksymalnie 10 lat.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

MonthlyRetentionRequired
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-RemovePolicy

Jeśli zostanie podana, zasady dla bazy danych zostaną wyczyszczone.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

RemovePolicy
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ServerName

Nazwa programu Azure SQL Server, w ramach których znajduje się baza danych.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-TimeBasedImmutability

Po ustawieniu przyszłe kopie zapasowe będą miały włączoną funkcję TimeBasedImmutability.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Akceptowane wartości:Enabled, Disabled
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-TimeBasedImmutabilityMode

Ustawienie trybu niezmienności opartego na czasie dla przyszłych kopii zapasowych. Obowiązują tylko wtedy, gdy włączono funkcję TimeBasedImmutability. Wartość może być zablokowana lub odblokowana. Przestroga: Nie można usunąć niezmienności kopii zapasowej LTR, jeśli TimeBasedImmutabilityMode jest zablokowany.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Akceptowane wartości:Unlocked, Locked
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WeeklyRetention

Tygodniowy okres przechowywania. Jeśli tylko liczba jest przekazywana zamiast ciągu ISO 8601, dni zostaną przyjęte jako jednostki. Istnieje co najmniej 7 dni i maksymalnie 10 lat.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

WeeklyRetentionRequired
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WeekOfYear

Tydzień roku, od 1 do 52, aby zapisać dla przechowywania yearly.

Właściwości parametrów

Typ:Int32
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

YearlyRetentionRequired
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-YearlyRetention

Przechowywanie roczne. Jeśli tylko liczba jest przekazywana zamiast ciągu ISO 8601, dni zostaną przyjęte jako jednostki. Istnieje co najmniej 7 dni i maksymalnie 10 lat.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

YearlyRetentionRequired
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

Int32

Wyjść

AzureSqlDatabaseBackupLongTermRetentionPolicyModel