Delen via

Set-AzSqlDatabaseBackupLongTermRetentionPolicy

Module:
Az.Sql Module

Hiermee stelt u een beleid voor langetermijnretentie van de server in.

Syntax

WeeklyRetentionRequired (Standaard) 

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

De cmdlet Set-AzSqlDatabaseBackupLongTermRetentionPolicy stelt het langetermijnretentiebeleid in dat is geregistreerd voor deze database. Het beleid is een Azure Backup resource die wordt gebruikt voor het definiëren van back-upopslagbeleid.

Voorbeelden

Voorbeeld 1: De wekelijkse bewaarperiode instellen voor de huidige versie van beleid voor langetermijnretentie

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

Hiermee stelt u het langetermijnretentiebeleid van database01 in om elke wekelijkse volledige back-up gedurende 2 weken op te slaan

Voorbeeld 2: De maandelijkse retentie instellen voor de huidige versie van beleid voor langetermijnretentie

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

Hiermee stelt u het langetermijnretentiebeleid van database01 in om de eerste volledige back-up van elke maand gedurende 5 jaar op te slaan

Voorbeeld 3: De jaarlijkse bewaarperiode instellen voor de huidige versie van beleid voor langetermijnretentie

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

Hiermee stelt u het langetermijnretentiebeleid van database01 in om de volledige back-up op te slaan die in de 26e week van het jaar gedurende 10 jaar is gemaakt

Voorbeeld 4: Stel de jaarlijkse retentie in voor de huidige versie van beleid voor langetermijnretentie met een niet-vergrendelde onveranderbaarheid op basis van tijd ingeschakeld

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

Hiermee stelt u het langetermijnretentiebeleid van database01 in om de volledige back-up op te slaan die in de 26e week van het jaar gedurende tien jaar is gemaakt. Daarnaast worden de back-ups gemaakt met een ontgrendeld beleid voor onveranderbaarheid op basis van tijd. Deze back-ups kunnen later hun onveranderbaarheid vergrendeld of verwijderd hebben.

Voorbeeld 5: Stel de jaarlijkse retentie in voor de huidige versie van beleid voor langetermijnretentie met een vergrendelde onveranderbaarheid op basis van tijd ingeschakeld

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

Hiermee stelt u het langetermijnretentiebeleid van database01 in om de volledige back-up op te slaan die in de 26e week van het jaar gedurende tien jaar is gemaakt. Bovendien worden de back-ups gemaakt met een vergrendeld beleid voor onveranderbaarheid op basis van tijd. Deze back-ups kunnen niet handmatig worden verwijderd en worden alleen verwijderd na verloop van tijd.

Voorbeeld 6: Elke bewaarperiode instellen voor de huidige versie van beleid voor langetermijnretentie

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

Hiermee stelt u het langetermijnretentiebeleid van database01 in om elke volledige back-up gedurende 14 dagen op te slaan, de eerste volledige back-up van elke maand gedurende 24 weken en de volledige back-up die op de 26e week van het jaar gedurende tien jaar is gemaakt

Voorbeeld 7: Het beleid voor langetermijnretentie verwijderen

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

Hiermee verwijdert u het beleid voor database01, zodat er geen langetermijnretentieback-ups meer worden opgeslagen. Dit heeft geen invloed op back-ups die al zijn gemaakt.

Voorbeeld 8: Het beleid voor langetermijnretentie verwijderen

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

Dit is een andere manier om het beleid voor database01 te verwijderen, zodat er geen langetermijnretentieback-ups meer worden opgeslagen. Dit heeft geen invloed op back-ups die al zijn gemaakt

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DatabaseName

De naam van de Azure SQL Database die u wilt gebruiken.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MonthlyRetention

De maandelijkse retentie. Als er slechts een getal wordt doorgegeven in plaats van een ISO 8601-tekenreeks, worden dagen als eenheden beschouwd. Er is minimaal 7 dagen en maximaal 10 jaar.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

MonthlyRetentionRequired
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-RemovePolicy

Indien opgegeven, wordt het beleid voor de database gewist.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RemovePolicy
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

De naam van de resourcegroep.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ServerName

De naam van de Azure SQL Server de database zich bevindt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-TimeBasedImmutability

Als dit is ingesteld, is TimeBasedImmutability ingeschakeld voor toekomstige back-ups.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Enabled, Disabled
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-TimeBasedImmutabilityMode

De instelling voor de tijdgebaseerde onveranderbaarheidsmodus voor toekomstige back-ups. Alleen effectief als TimeBasedImmutability is ingeschakeld. De waarde kan vergrendeld of ontgrendeld zijn. Let op: De onveranderlijkheid van LTR-back-up kan niet worden verwijderd als TimeBasedImmutabilityMode is vergrendeld.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Unlocked, Locked
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WeeklyRetention

De wekelijkse retentie. Als er slechts een getal wordt doorgegeven in plaats van een ISO 8601-tekenreeks, worden dagen als eenheden beschouwd. Er is minimaal 7 dagen en maximaal 10 jaar.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WeeklyRetentionRequired
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WeekOfYear

De week van het jaar, 1 tot 52, om op te slaan voor de jaarlijkse retentie.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

YearlyRetentionRequired
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-YearlyRetention

De jaarlijkse retentie. Als er slechts een getal wordt doorgegeven in plaats van een ISO 8601-tekenreeks, worden dagen als eenheden beschouwd. Er is minimaal 7 dagen en maximaal 10 jaar.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

YearlyRetentionRequired
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Int32

Uitvoerwaarden

AzureSqlDatabaseBackupLongTermRetentionPolicyModel