你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzSqlDatabaseBackupLongTermRetentionPolicy

模块:

Az.Sql

设置服务器长期保留策略。

语法

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

说明

Set-AzSqlDatabaseBackupLongTermRetentionPolicy cmdlet 设置注册到此数据库的长期保留策略。 该策略是用于定义备份存储策略的 Azure 备份资源。

示例

示例 1：为当前版本的长期保留策略设置每周保留期

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                               :

这将设置 database01 的长期保留策略，以便将每周完整备份保存 2 周

示例 2：为当前版本的长期保留策略设置每月保留期

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                               :

这将设置 database01 的长期保留策略，以便将每月的第一个完整备份保存到 5 年

示例 3：为当前版本的长期保留策略设置每年保留期

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                               :

这将设置 database01 的长期保留策略，以保存 10 年来在年度第 26 周执行的完整备份

示例 4：为当前版本的长期保留策略设置每个保留期

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                               :

这将设置 database01 的长期保留策略，以便将每个完整备份保存 14 天，每月第一次完整备份 24 周，以及 10 年来第 26 周执行的完整备份

示例 5：删除长期保留策略

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

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

删除 database01 的策略，使其不再保存任何长期保留备份。 这不会影响已创建的备份

示例 6：删除长期保留策略

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                               :

这是删除 database01 策略的另一种方法，因此它不再保存任何长期保留备份。 这不会影响已创建的备份

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DatabaseName

要使用的 Azure SQL 数据库的名称。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MonthlyRetention

每月保留期。 如果只传递数字而不是 ISO 8601 字符串，则天数将假定为单位。 至少有 7 天，最多 10 年。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-RemovePolicy

如果提供，将删除数据库的策略。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ServerName

数据库位于的 Azure SQL Server 的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WeeklyRetention

每周保留期。 如果只传递数字而不是 ISO 8601 字符串，则天数将假定为单位。 至少有 7 天，最多 10 年。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WeekOfYear

年份周，1 到 52，用于保存每年保留期。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-YearlyRetention

每年保留期。 如果只传递数字而不是 ISO 8601 字符串，则天数将假定为单位。 至少有 7 天，最多 10 年。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

String

Int32

输出

AzureSqlDatabaseBackupLongTermRetentionPolicyModel

相关链接

• Get-AzSqlDatabaseLongTermRetentionBackup
• Update-AzSqlDatabaseLongTermRetentionBackup
• Copy-AzSqlDatabaseLongTermRetentionBackup
• Remove-AzSqlDatabaseLongTermRetentionBackup
• Get-AzSqlDatabaseBackupLongTermRetentionPolicy
• SQL 数据库文档