Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy
Nastaví zásady dlouhodobého uchovávání serveru.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
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
Rutina Set-AzureRmSqlDatabaseBackupLongTermRetentionPolicy nastaví zásady dlouhodobého uchovávání informací zaregistrované do této databáze. Zásada je prostředek služby Azure Backup, který slouží k definování zásad úložiště zálohování.
Příklady
Příklad 1: Nastavení týdenního uchovávání pro aktuální verzi zásad dlouhodobého uchovávání
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 :
Tím se nastaví zásady dlouhodobého uchovávání databáze01 tak, aby se každé týdenní úplné zálohování uložilo po dobu 2 týdnů.
Příklad 2: Nastavení měsíčního uchovávání pro aktuální verzi zásad dlouhodobého uchovávání
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 :
Tím se nastaví zásady dlouhodobého uchovávání databáze01, aby se první úplná záloha každého měsíce uložila po dobu 5 let.
Příklad 3: Nastavení ročního uchovávání pro aktuální verzi zásad dlouhodobého uchovávání
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 :
Tím se nastaví zásady dlouhodobého uchovávání databáze01, aby se 10 let uložila úplná záloha pořízená 26. týdnem v roce.
Příklad 4: Nastavení každého uchovávání pro aktuální verzi zásad dlouhodobého uchovávání
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 :
Tím nastavíte zásady dlouhodobého uchovávání databáze01 tak, aby se každá úplná záloha uložila po dobu 14 dnů, první úplné zálohování každého měsíce po dobu 24 týdnů a úplné zálohování pořízené v 26. týdnu roku po dobu 10 let.
Příklad 4: Odebrání zásad dlouhodobého uchovávání
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 :
Odebere zásadu pro databázi01, takže už neukládá žádné dlouhodobé zálohy uchovávání informací. Nebude to mít vliv na zálohy, které už byly pořízeny.
Příklad 4: Odebrání zásad dlouhodobého uchovávání
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 :
Toto je další způsob odebrání zásad pro databázi01, takže už neukládá žádné dlouhodobé uchovávání záloh. Nebude to mít vliv na zálohy, které už byly pořízeny.
Parametry
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseName
Název azure SQL Database, který se má použít.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MonthlyRetention
Měsíční uchovávání. Pokud se místo řetězce ISO 8601 předá jenom číslo, budou se jako jednotky předpokládat dny. Je minimální 7 dní a maximálně 10 let.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RemovePolicy
Pokud je tato zásada za předpokladu, odebere se zásada databáze.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Název skupiny zdrojů.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
ID prostředku zásady dlouhodobého uchovávání záloh.
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServerName
Název Azure SQL Serveru, ve které je databáze.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-State
Stav zásad dlouhodobého uchovávání záloh, Povoleno nebo Zakázáno
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WeeklyRetention
Týdenní uchovávání. Pokud se místo řetězce ISO 8601 předá jenom číslo, budou se jako jednotky předpokládat dny. Je minimální 7 dní a maximálně 10 let.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WeekOfYear
Týden roku, 1 až 52, aby se ušetřilo pro roční uchovávání.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-YearlyRetention
Roční uchovávání. Pokud se místo řetězce ISO 8601 předá jenom číslo, budou se jako jednotky předpokládat dny. Je minimální 7 dní a maximálně 10 let.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Vstupy
Výstupy
AzureSqlDatabaseBackupLongTermRetentionPolicyModel