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 コマンドレットは、このデータベースに登録されている長期保持ポリシーを設定します。 このポリシーは、バックアップ ストレージ ポリシーの定義に使用される Azure Backup リソースです。

例

例 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 の長期保有ポリシーが設定され、1 年の第 26 週に作成された完全バックアップが 10 年間保存されます。

例 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 のポリシーを削除するもう 1 つの方法であり、長期的な保有バックアップが保存されなくなります。 これは、既に作成されているバックアップには影響しません

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DatabaseName

使用する Azure SQL Database の名前。

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

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

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

-MonthlyRetention

月単位のリテンション期間。 ISO 8601 文字列の代わりに数値のみを渡す場合、日数は単位と見なされます。 7 日以上、最大 10 年です。

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

-RemovePolicy

指定した場合、データベースのポリシーは削除されます。

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

-ResourceGroupName

リソース グループの名前。

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

-ServerName

データベースが格納されている Azure SQL Server の名前。

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

-WeeklyRetention

週単位のリテンション期間。 ISO 8601 文字列の代わりに数値のみを渡す場合、日数は単位と見なされます。 7 日以上、最大 10 年です。

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

-WeekOfYear

年単位のリテンション期間に保存する年の週 (1 ~ 52)。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

-YearlyRetention

年単位のリテンション期間。 ISO 8601 文字列の代わりに数値のみを渡す場合、日数は単位と見なされます。 7 日以上、最大 10 年です。

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

入力

String

Int32

出力

AzureSqlDatabaseBackupLongTermRetentionPolicyModel

関連リンク

• Get-AzSqlDatabaseLongTermRetentionBackup
• Update-AzSqlDatabaseLongTermRetentionBackup
• Copy-AzSqlDatabaseLongTermRetentionBackup
• Remove-AzSqlDatabaseLongTermRetentionBackup
• Get-AzSqlDatabaseBackupLongTermRetentionPolicy
• SQL Database のドキュメント