Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy

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

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy
   -WeeklyRetention <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy
   -State <String>
   -ResourceId <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy
   [-RemovePolicy]
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy
   [-WeeklyRetention <String>]
   -MonthlyRetention <String>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy
   [-WeeklyRetention <String>]
   [-MonthlyRetention <String>]
   -YearlyRetention <String>
   -WeekOfYear <Int32>
   [-ServerName] <String>
   [-DatabaseName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy 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

PS C:\> Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -WeeklyRetention P2W


ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : P2W
MonthlyRetention                       : PT0S
YearlyRetention                        : PT0S
WeekOfYear                             : 0
State                                  :
RecoveryServicesBackupPolicyResourceId :
Location                               :

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

PS C:\> Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -MonthlyRetention P5Y


ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : P5Y
YearlyRetention                        : PT0S
WeekOfYear                             : 0
State                                  :
RecoveryServicesBackupPolicyResourceId :
Location                               :

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

PS C:\> Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -YearlyRetention P10Y -WeekOfYear 26


ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : P10Y
WeekOfYear                             : 26
State                                  :
RecoveryServicesBackupPolicyResourceId :
Location                               :

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: Elke bewaarperiode instellen voor de huidige versie van beleid voor langetermijnretentie

PS C:\> Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy -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
State                                  :
RecoveryServicesBackupPolicyResourceId :
Location                               :

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 4: Het langetermijnretentiebeleid verwijderen

PS C:\> Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -RemovePolicy


ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : PT0S
WeekOfYear                             : 0
State                                  :
RecoveryServicesBackupPolicyResourceId :
Location                               :

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 4: Het langetermijnretentiebeleid verwijderen

PS C:\> Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -WeeklyRetention P0D


ResourceGroupName                      : resourcegroup01
ServerName                             : server01
DatabaseName                           : database01
WeeklyRetention                        : PT0S
MonthlyRetention                       : PT0S
YearlyRetention                        : PT0S
WeekOfYear                             : 0
State                                  :
RecoveryServicesBackupPolicyResourceId :
Location                               :

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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DatabaseName

De naam van de Te gebruiken Azure SQL Database.

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

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 een minimumum van 7 dagen en maximaal 10 jaar.

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

-RemovePolicy

Indien opgegeven, wordt het beleid voor de database verwijderd.

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

-ResourceGroupName

De naam van de resourcegroep.

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

-ResourceId

De resource-id van het langetermijnretentiebeleid voor back-ups.

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

-ServerName

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

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

-State

De status van het back-upbeleid voor langetermijnretentie, Ingeschakeld of Uitgeschakeld

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 een minimumum van 7 dagen en maximaal 10 jaar.

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

-WeekOfYear

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

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 een minimumum van 7 dagen en maximaal 10 jaar.

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

Invoerwaarden

String

Int32

Uitvoerwaarden

AzureSqlDatabaseBackupLongTermRetentionPolicyModel