Set-AzSqlDatabaseBackupLongTermRetentionPolicy

  • Referens
Modul:
Az.Sql

Anger en långsiktig kvarhållningsprincip för servern.

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

Cmdleten Set-AzSqlDatabaseBackupLongTermRetentionPolicy anger den långsiktiga kvarhållningsprincipen som är registrerad i den här databasen. Principen är en Azure Backup-resurs som används för att definiera en lagringsprincip för säkerhetskopiering.

Exempel

Exempel 1: Ange veckovis kvarhållning för den aktuella versionen av principen för långsiktig kvarhållning

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                               :

Detta anger den långsiktiga kvarhållningsprincipen för database01 för att spara varje veckovis fullständig säkerhetskopiering i 2 veckor

Exempel 2: Ange månatlig kvarhållning för den aktuella versionen av principen för långsiktig kvarhållning

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                               :

Detta anger den långsiktiga kvarhållningsprincipen för database01 för att spara den första fullständiga säkerhetskopian för varje månad i 5 år

Exempel 3: Ange årlig kvarhållning för den aktuella versionen av principen för långsiktig kvarhållning

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                               :

Detta anger den långsiktiga kvarhållningsprincipen för database01 för att spara den fullständiga säkerhetskopieringen som gjordes den 26:e veckan på året i 10 år

Exempel 4: Ange varje kvarhållning för den aktuella versionen av principen för långsiktig kvarhållning

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                               :

Detta anger den långsiktiga kvarhållningsprincipen för database01 för att spara varje fullständig säkerhetskopia i 14 dagar, den första fullständiga säkerhetskopian av varje månad i 24 veckor och den fullständiga säkerhetskopieringen som gjordes den 26:e veckan på året i 10 år

Exempel 5: Ta bort principen för långsiktig kvarhållning

Set-AzSqlDatabaseBackupLongTermRetentionPolicy -ResourceGroupName resourcegroup01 -ServerName server01 -DatabaseName database01 -RemovePolicy

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

Tar bort principen för database01 så att den inte längre sparar några långsiktiga kvarhållningssäkerhetskopior. Detta påverkar inte säkerhetskopieringar som redan har gjorts

Exempel 6: Ta bort principen för långsiktig kvarhållning

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                               :

Det här är ett annat sätt att ta bort principen för database01 så att den inte längre sparar några långsiktiga kvarhållningssäkerhetskopior. Detta påverkar inte säkerhetskopieringar som redan har gjorts

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DatabaseName

Namnet på den Azure SQL Database som ska användas.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonthlyRetention

Månatlig kvarhållning. Om bara ett tal skickas i stället för en ISO 8601-sträng antas dagar som enheter. Det finns minst 7 dagar och högst 10 år.

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

-RemovePolicy

Om det anges tas principen för databasen bort.

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

-ResourceGroupName

Namnet på resursgruppen.

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

-ServerName

Namnet på den Azure SQL Server som databasen finns i.

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

-WeeklyRetention

Veckovis kvarhållning. Om bara ett tal skickas i stället för en ISO 8601-sträng antas dagar som enheter. Det finns minst 7 dagar och högst 10 år.

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

-WeekOfYear

Veckan på året, 1 till 52, för att spara för den årliga kvarhållningen.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

-YearlyRetention

Den årliga kvarhållningen. Om bara ett tal skickas i stället för en ISO 8601-sträng antas dagar som enheter. Det finns minst 7 dagar och högst 10 år.

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

Indata

String

Int32

Utdata

AzureSqlDatabaseBackupLongTermRetentionPolicyModel