Edit-AzDataProtectionPolicyRetentionRuleClientObject

Модуль:: Az.DataProtection Module

Добавляет или удаляет правило хранения в существующую политику резервного копирования.

Синтаксис

RemoveRetention (По умолчанию)

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

AddRetention

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

Описание

Добавляет или удаляет правило хранения в существующую политику резервного копирования.

Примеры

Пример 1. Добавление еженедельного правила хранения

$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

Первая команда получает шаблон политики по умолчанию. Вторая команда создает объект еженедельного жизненного цикла. Третья команда добавляет еженедельное правило хранения в политику по умолчанию.

Пример 2. Удаление правила еженедельного хранения

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

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

Эта команда удаляет еженедельное правило хранения, если оно существует в данной политике резервного копирования.

Пример 3. Добавление правила хранения OperationsStore в политику 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

Для AzureBlob необходимо назватьDefault_OperationalStoreправила хранения OperationsStore. Правило добавляется аддитивно— существующее Default правило хранения (VaultStore) в шаблоне политики сохраняется. Передача -Name Default с жизненным циклом OperationsStore отклоняется проверкой.

Примечание. -OverwriteLifeCycle Не рекомендуется и будет удален в предстоящем выпуске. Установка -OverwriteLifeCycle $false блоков обновления существующего правила хранения; если $true или опущен, жизненные циклы существующего правила заменяются на месте — поведение по умолчанию после удаления этого параметра.

Параметры

-IsDefault

Указывает, является ли правило хранения правилом хранения по умолчанию.

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

AddRetention

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-LifeCycles

Жизненные циклы, связанные с правилом хранения.

Свойства параметров

Тип:	ISourceLifeCycle[]
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

AddRetention

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

Имя правила хранения. Примечание. "Default" Правила хранения нельзя удалить независимо от жизненного цикла.

Свойства параметров

Тип:	RetentionRuleName
Значение по умолчанию:	None
Допустимые значения:	Default, Daily, Weekly, Monthly, Yearly, Default_OperationalStore
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-OverwriteLifeCycle

[Не рекомендуется] Дополнительные; этот параметр будет удален в предстоящем выпуске. Установка -OverwriteLifeCycle $false блоков обновления существующего правила хранения; если $true или опущен, жизненные циклы существующего правила заменяются на месте — поведение по умолчанию после удаления этого параметра.

Свойства параметров

Тип:	Nullable<T>[Boolean]
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

AddRetention

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Policy

Объект политики резервного копирования

Свойства параметров

Тип:	IBackupPolicy
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-RemoveRule

Указывает, следует ли удалить правило хранения.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

RemoveRetention

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

IBackupPolicy

Примечания

"Default" Правила хранения нельзя удалить независимо от жизненного цикла. -RemoveRule -Name Default Бросает Removing Default Retention Rule is not allowed. Please try again with different rule name.
-OverwriteLifeCycle устарел и будет удален в предстоящем выпуске. Установка -OverwriteLifeCycle $false блоков обновления существующего правила хранения; если $true или опущен, жизненные циклы существующего правила заменяются на месте — поведение по умолчанию после удаления этого параметра.

Обратная связь

Были ли сведения на этой странице полезными?