Edit-AzDataProtectionPolicyRetentionRuleClientObject

Modul:

Az.DataProtection Module

Přidá nebo odebere pravidlo uchovávání informací do existujících zásad zálohování.

Syntax

RemoveRetention (Výchozí)

Edit-AzDataProtectionPolicyRetentionRuleClientObject
    -Policy <IBackupPolicy>
    -Name <RetentionRuleName>
    [-RemoveRule]
    [<CommonParameters>]

AddRetention

Edit-AzDataProtectionPolicyRetentionRuleClientObject
    -Policy <IBackupPolicy>
    -Name <RetentionRuleName>
    -IsDefault <Boolean>
    -LifeCycles <ISourceLifeCycle[]>
    [-OverwriteLifeCycle <Boolean>]
    [<CommonParameters>]

Description

Přidá nebo odebere pravidlo uchovávání informací do existujících zásad zálohování.

Příklady

Příklad 1: Přidání týdenního pravidla uchovávání informací

$pol = Get-AzDataProtectionPolicyTemplate
$lifecycle = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore OperationalStore -SourceRetentionDurationType Weeks -SourceRetentionDurationCount 5
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -LifeCycles $lifecycle -IsDefault $false

DatasourceType            ObjectType
--------------            ----------
{Microsoft.Compute/disks} BackupPolicy

První příkaz získá výchozí šablonu zásad. Druhý příkaz vytvoří týdenní objekt životního cyklu. Třetí příkaz přidá do výchozí zásady týdenní pravidlo uchovávání informací.

Příklad 2: Odebrání týdenního pravidla uchovávání informací

Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -RemoveRule

DatasourceType            ObjectType
--------------            ----------
{Microsoft.Compute/disks} BackupPolicy

Tento příkaz odebere pravidlo týdenního uchovávání informací, pokud existuje v dané zásadě zálohování.

Příklad 3: Přidání pravidla uchovávání provozního úložiště do zásad AzureBlob

$pol = Get-AzDataProtectionPolicyTemplate -DatasourceType AzureBlob
$opLifecycle = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore OperationalStore -SourceRetentionDurationType Days -SourceRetentionDurationCount 30
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Default_OperationalStore -LifeCycles $opLifecycle -IsDefault $true

DatasourceType                                  ObjectType
--------------                                  ----------
{Microsoft.Storage/storageAccounts/blobServices} BackupPolicy

V případě AzureBlob musí být pravidla uchovávání provozního úložiště pojmenována Default_OperationalStore. Pravidlo je přidáno doplňkově – zachová se stávající Default pravidlo uchovávání informací (VaultStore) v šabloně zásad. Předání -Name Default životního cyklu OperationalStore je zamítnuto ověřením.

Poznámka: -OverwriteLifeCycle Je zastaralý a bude odebrán v nadcházející verzi. Nastavení -OverwriteLifeCycle $false bloků aktualizace existujícího pravidla uchovávání informací. Když $true nebo vynecháte, životní cyklus stávajícího pravidla se nahradí – výchozí chování po odebrání tohoto parametru.

Parametry

-IsDefault

Určuje, jestli je pravidlo uchovávání výchozího pravidla uchovávání informací.

Vlastnosti parametru

Typ:	Boolean
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AddRetention

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-LifeCycles

Životní cykly přidružené k pravidlu uchovávání.

Vlastnosti parametru

Typ:	ISourceLifeCycle[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AddRetention

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Název pravidla uchovávání informací Poznámka: "Default" Pravidla uchovávání informací nelze odebrat bez ohledu na životní cyklus.

Vlastnosti parametru

Typ:	RetentionRuleName
Default value:	None
Přípustné hodnoty:	Default, Daily, Weekly, Monthly, Yearly, Default_OperationalStore
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-OverwriteLifeCycle

[Zastaralé] Volitelné; tento parametr bude odebrán v nadcházející verzi. Nastavení -OverwriteLifeCycle $false bloků aktualizace existujícího pravidla uchovávání informací. Když $true nebo vynecháte, životní cyklus stávajícího pravidla se nahradí – výchozí chování po odebrání tohoto parametru.

Vlastnosti parametru

Typ:	Nullable<T>[Boolean]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AddRetention

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Policy

Objekt zásad zálohování

Vlastnosti parametru

Typ:	IBackupPolicy
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RemoveRule

Určuje, jestli se má pravidlo uchovávání odebrat.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

RemoveRetention

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Výstupy

IBackupPolicy

Poznámky

• "Default" Pravidla uchovávání informací nelze odebrat bez ohledu na životní cyklus. -RemoveRule -Name Default Vyvolá Removing Default Retention Rule is not allowed. Please try again with different rule name.
• -OverwriteLifeCycle je zastaralý a bude odebrán v nadcházející verzi. Nastavení -OverwriteLifeCycle $false bloků aktualizace existujícího pravidla uchovávání informací. Když $true nebo vynecháte, životní cyklus stávajícího pravidla se nahradí – výchozí chování po odebrání tohoto parametru.