Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy

Set-AzSqlInstanceDatabaseLongTermRetentionBackup Cmdlet 會設定受控資料庫的長期保留原則。

語法

WeeklyRetentionRequired (預設值)

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy
    [-InstanceName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    -WeeklyRetention <String>
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemovePolicy

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy
    [-InstanceName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    [-RemovePolicy]
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

MonthlyRetentionRequired

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy
    [-InstanceName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    -MonthlyRetention <String>
    [-WeeklyRetention <String>]
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

YearlyRetentionRequired

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy
    [-InstanceName] <String>
    [-DatabaseName] <String>
    [-ResourceGroupName] <String>
    -YearlyRetention <String>
    -WeekOfYear <Int32>
    [-WeeklyRetention <String>]
    [-MonthlyRetention <String>]
    [-TimeBasedImmutability <String>]
    [-TimeBasedImmutabilityMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy Cmdlet 會設定此受控資料庫的長期保留原則。

範例

範例 1

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy -ResourceGroupName testResourceGroup -InstanceName testInstance -DatabaseName test -WeeklyRetention "P1W"
ResourceGroupName   : testResourceGroup
ManagedInstanceName : testInstance
DatabaseName        : test
WeeklyRetention     : P1W
MonthlyRetention    : PT0S
YearlyRetention     : PT0S
WeekOfYear          : 0
Location            :
TimeBasedImmutability     : Disabled
TimeBasedImmutabilityMode : Unlocked

將資料庫的長期保留每週原則設定為一週。

範例 2

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy -ResourceGroupName testResourceGroup -InstanceName testInstance -DatabaseName target1 -RemovePolicy
ResourceGroupName   : testResourceGroup
ManagedInstanceName : testInstance
DatabaseName        : target1
WeeklyRetention     : PT0S
MonthlyRetention    : PT0S
YearlyRetention     : PT0S
WeekOfYear          : 0
Location            :
TimeBasedImmutability     : Disabled
TimeBasedImmutabilityMode : Unlocked

此命令會從資料庫中移除長期保留原則。

範例 3

Set-AzSqlInstanceDatabaseLongTermRetentionBackup Cmdlet 會設定受控資料庫的長期保留原則。 (autogenerated)

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy -DatabaseName target1 -InstanceName testInstance -MonthlyRetention P24W -ResourceGroupName testResourceGroup -WeekOfYear 26 -WeeklyRetention 'P1W' -YearlyRetention P10Y

範例 4:啟用解鎖的時間基礎不變性,以供未來 LTR 備份使用

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy -ResourceGroupName testResourceGroup -InstanceName testInstance -DatabaseName test -YearlyRetention P10Y -WeekOfYear 26 -TimeBasedImmutability Enabled
ResourceGroupName          : testResourceGroup
ManagedInstanceName        : testInstance
DatabaseName               : test
WeeklyRetention            : PT0S
MonthlyRetention           : PT0S
YearlyRetention            : P10Y
WeekOfYear                 : 26
Location                   :
TimeBasedImmutability      : Enabled
TimeBasedImmutabilityMode  : Unlocked

設定未來的長期備份,並解鎖基於時間的不可變性。 它們的不變性之後可以被鎖定或移除。

範例 5:啟用鎖定的時間基礎不變性,以供未來 LTR 備份使用

Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy -ResourceGroupName testResourceGroup -InstanceName testInstance -DatabaseName test -YearlyRetention P10Y -WeekOfYear 26 -TimeBasedImmutability Enabled -TimeBasedImmutabilityMode Locked
ResourceGroupName          : testResourceGroup
ManagedInstanceName        : testInstance
DatabaseName               : test
WeeklyRetention            : PT0S
MonthlyRetention           : PT0S
YearlyRetention            : P10Y
WeekOfYear                 : 26
Location                   :
TimeBasedImmutability      : Enabled
TimeBasedImmutabilityMode  : Locked

設定未來的長期備份,並以鎖定的時間為基礎的不可變性。 鎖定的不可變性無法移除,備份也無法手動刪除。

參數

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DatabaseName

使用 Azure 管理資料庫的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:2
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DefaultProfile

用於與 Azure 通訊的憑證、帳號、租戶和訂閱。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InstanceName

資料庫所屬的Azure 受控執行個體名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-MonthlyRetention

每月保留。 如果只傳遞一個數字而不是 ISO 8601 字串,則將假設天數作為單位。 最短7天,最長10年。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

MonthlyRetentionRequired
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-RemovePolicy

如果提供,則會清除資料庫的原則。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

RemovePolicy
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

資源群組的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-TimeBasedImmutability

設置后,將來的備份將啟用 TimeBasedImmutableability。

參數屬性

類型:String
預設值:None
接受的值:Enabled, Disabled
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-TimeBasedImmutabilityMode

未來備份的基於時間的不變性模式的設定。 只有在啟用 TimeBasedImmutability 時才有效。 值可以是 Locked 或 Unlocked。 注意:如果 TimeBasedImmutabilityMode 為 Locked,則無法刪除 LTR 備份的不變性。

參數屬性

類型:String
預設值:None
接受的值:Unlocked, Locked
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WeeklyRetention

每週保留。 如果只傳遞一個數字而不是 ISO 8601 字串,則將假設天數作為單位。 最短7天,最長10年。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

WeeklyRetentionRequired
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WeekOfYear

一年中的第 1 至 52 週,以節省每年的保留。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

YearlyRetentionRequired
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:WI

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-YearlyRetention

每年的保留。 如果只傳遞一個數字而不是 ISO 8601 字串,則將假設天數作為單位。 最短7天,最長10年。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

YearlyRetentionRequired
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

String

Int32

輸出

AzureSqlManagedDatabaseBackupLongTermRetentionPolicyModel