Update-AzDataProtectionBackupVault

Модуль:

Az.DataProtection

Обновляет ресурс BackupVault, принадлежащий группе ресурсов. Например, обновление тегов для ресурса.

Синтаксис

Update-AzDataProtectionBackupVault
      [-Token <String>]
      [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
      [-CrossRegionRestoreState <CrossRegionRestoreState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-IdentityType <String>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-ImmutabilityState <ImmutabilityState>]
      [-ResourceGuardOperationRequest <String[]>]
      [-SoftDeleteRetentionDurationInDay <Double>]
      [-SoftDeleteState <SoftDeleteState>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      -ResourceGroupName <String>
      -VaultName <String>
      [-SubscriptionId <String>]
      [-CmkEncryptionState <EncryptionState>]
      [-CmkIdentityType <IdentityType>]
      [-CmkUserAssignedIdentityId <String>]
      [-CmkEncryptionKeyUri <String>]
      [-SecureToken <SecureString>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzDataProtectionBackupVault
      -InputObject <IDataProtectionIdentity>
      [-Token <String>]
      [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
      [-CrossRegionRestoreState <CrossRegionRestoreState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-EncryptionSetting <IEncryptionSettings>]
      [-IdentityType <String>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-ImmutabilityState <ImmutabilityState>]
      [-ResourceGuardOperationRequest <String[]>]
      [-SoftDeleteRetentionDurationInDay <Double>]
      [-SoftDeleteState <SoftDeleteState>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Обновляет ресурс BackupVault, принадлежащий группе ресурсов. Например, обновление тегов для ресурса.

Примеры

Пример 1. Добавление тегов в существующее хранилище резервных копий

$tag = @{"Owner"="sarath";"Purpose"="AzureBackupTesting"}
Update-AzDataProtectionBackupVault -SubscriptionId "xxx-xxx-xxx" -ResourceGroupName sarath-rg -VaultName sarath-vault -Tag $tag

ETag IdentityPrincipalId                  IdentityTenantId                     IdentityType   Location      Name         Type
---- -------------------                  ----------------                     ------------   --------      ----         ----
     2ca1d5f7-38b3-4b61-aa45-8147d7e0edbc 72f988bf-86f1-41af-91ab-2d7cd011db47 SystemAssigned centraluseuap sarath-vault Microsoft.DataProtection/backupVaults

Первая команда создает хэш-файл тега с тегами и их значениями. Вторая команда добавляет указанные теги в хранилище резервных копий.

Пример 2. Отключение оповещений Azure Monitor для сбоев заданий

Update-AzDataProtectionBackupVault -ResourceGroupName "rgName" -VaultName "vaultName" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -AzureMonitorAlertsForAllJobFailure 'Disabled'

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

Эта команда отключает оповещения монитора для всех сбоев заданий для хранилища резервных копий. Допустимые значения: "Включено", "Отключено". Обратите внимание, что по умолчанию этот параметр включен.

Пример 3. Обновление хранилища неизменяемостиState, CrossSubscriptionRestoreState, параметры обратимого удаления

Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CrossSubscriptionRestoreState Disabled -ImmutabilityState Disabled -SoftDeleteRetentionDurationInDay 99 -SoftDeleteState Off

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

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

Пример 4. Обновление хранилища CmkIdentityType из UserAssignedManagedIdentity в SystemAssignedManagedIdentity и CmkEncryptionKeyUri

$cmkKeyUri = "https://samplekvazbckp.vault.azure.net/keys/testkey/3cd5235ad6ac4c11b40a6f35444bcbe1"

Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CmkIdentityType SystemAssigned -CmkEncryptionKeyUri $cmkKeyUri

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

Эта команда используется для изменения CmkIdentityType и CmkEncryptionKeyUri. Эти параметры являются необязательными и могут использоваться независимо.

Пример 5. Обновление хранилища CmkIdentityType из SystemAssignedManagedIdentity до UserAssignedManagedIdentity

$cmkIdentityId = "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami"

Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CmkIdentityType UserAssigned -CmkUserAssignedIdentityId $cmkIdentityId

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults UserAssigned

Эта команда используется для изменения CmkIdentityType с SystemAssigned на UserAssgined. CmkIdenityId — обязательный параметр.

Пример 6. Обновление хранилища для назначения управляемого удостоверения, назначаемого пользователем (UAMI)

$UAMI = @{"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userAssignedIdentityName"=[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api40.UserAssignedIdentity]::new()}

$vault = Update-AzDataProtectionBackupVault -AssignUserIdentity $UAMI -SubscriptionId "00000000-0000-0000-0000-000000000000" -VaultName "vaultName" -ResourceGroupName "resourceGroupName" -IdentityType 'SystemAssigned,UserAssigned'

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned, UserAssigned

Сначала создайте хэш-таблицу для объекта UAMI. Этот объект сопоставляет идентификатор ресурса UAMI с новым экземпляром UserAssignedIdentity. Затем используйте командлет Update-AzDataProtectionBackupVault, чтобы назначить UAMI хранилищу резервных копий при сохранении управляемого удостоверения, назначенного системой. Параметр -IdentityType указывает, что используются удостоверения SystemAssigned и UserAssigned.

Параметры

-AsJob

Выполнение команды в качестве задания

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AzureMonitorAlertsForAllJobFailure

Параметр включения или отключения встроенных оповещений Azure Monitor для сбоев заданий. Оповещения системы безопасности не могут быть отключены.

Тип:	AlertsState
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CmkEncryptionKeyUri

Универсальный код ресурса (URI) ключа CMK, который будет использоваться для шифрования. Чтобы включить автоматическую смену ключей, исключите компонент версии из URI ключа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CmkEncryptionState

Включите состояние шифрования CMK для хранилища резервных копий.

Тип:	EncryptionState
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CmkIdentityType

Тип удостоверения, используемый для шифрования CMK— SystemAssigned или UserAssigned Identity.

Тип:	IdentityType
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CmkUserAssignedIdentityId

Этот параметр требуется, если тип удостоверения — UserAssigned. Добавьте идентификатор управляемого удостоверения, назначаемый пользователем, который имеет разрешения на доступ к Key Vault.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CrossRegionRestoreState

Состояние восстановления между регионами хранилища. Допустимые значения отключены, включено.

Тип:	CrossRegionRestoreState
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CrossSubscriptionRestoreState

Состояние восстановления между подписками хранилища. Допустимые значения отключены, включено, постоянноdisabled.

Тип:	CrossSubscriptionRestoreState
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Параметр DefaultProfile не работает. Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.

Тип:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EncryptionSetting

Сведения о управляемом клиентом ключе ресурса. Сведения о создании см. в разделе NOTES для свойств ENCRYPTIONSETTING и создании хэш-таблицы.

Тип:	IEncryptionSettings
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IdentityType

IdentityType, который может быть systemAssigned, UserAssigned, SystemAssigned, SystemAssigned, UserAssigned или None

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IdentityUserAssignedIdentity

Возвращает или задает назначенные пользователем удостоверения.

Тип:	Hashtable
Aliases:	UserAssignedIdentity, AssignUserIdentity
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImmutabilityState

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

Тип:	ImmutabilityState
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Параметр удостоверений Для создания см. раздел NOTES для свойств INPUTOBJECT и создание хэш-таблицы.

Тип:	IDataProtectionIdentity
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-NoWait

Асинхронное выполнение команды

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceGroupName

Имя группы ресурсов. Имя не учитывает регистр.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceGuardOperationRequest

ResourceGuardOperationRequests, на котором будет выполнена проверка LAC

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecureToken

Параметр для авторизации операций, защищенных межтенантной защитой ресурсов. Используйте команду (Get-AzAccessToken -TenantId "xxxx-xxxx-xxxx-xxxx -AsSecureString"). Маркер для получения маркера авторизации для разного клиента.

Тип:	SecureString
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftDeleteRetentionDurationInDay

Длительность хранения обратимого удаления в днях.

Тип:	Double
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SoftDeleteState

Обратимое удаление состояния хранилища. Допустимые значения: Off, On, AlwaysOn.

Тип:	SoftDeleteState
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SubscriptionId

Идентификатор целевой подписки. Значение должно быть UUID.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tag

Теги ресурсов.

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Token

Параметр для авторизации операций, защищенных межтенантной защитой ресурсов. Используйте команду (Get-AzAccessToken -TenantId "xxxx-xxxx-xxxx-xxxx"). Маркер для получения маркера авторизации для разного клиента.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VaultName

Имя хранилища резервных копий.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

IDataProtectionIdentity

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

IBackupVaultResource