Update-AzRecoveryServicesVault

Модуль:

Az.RecoveryServices Module

Обновляет MSIdentity в хранилище служб восстановления.

Синтаксис

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

Update-AzRecoveryServicesVault
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-IdentityId <String[]>]
    [-RemoveUserAssigned]
    [-RemoveSystemAssigned]
    [-DisableClassicAlerts <Boolean>]
    [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
    [-DisableEmailNotificationsForSiteRecovery <Boolean>]
    [-DisableAzureMonitorAlertsForAllReplicationIssue <Boolean>]
    [-DisableAzureMonitorAlertsForAllFailoverIssue <Boolean>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-ImmutabilityState <ImmutabilityState>]
    [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
    [-CostManagementGranularity <CostManagementGranularity>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AzureRSVaultAddMSIdentity

Update-AzRecoveryServicesVault
    [-ResourceGroupName] <String>
    [-Name] <String>
    -IdentityType <MSIdentity>
    [-IdentityId <String[]>]
    [-DisableClassicAlerts <Boolean>]
    [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
    [-DisableEmailNotificationsForSiteRecovery <Boolean>]
    [-DisableAzureMonitorAlertsForAllReplicationIssue <Boolean>]
    [-DisableAzureMonitorAlertsForAllFailoverIssue <Boolean>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-ImmutabilityState <ImmutabilityState>]
    [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
    [-CostManagementGranularity <CostManagementGranularity>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Этот командлет используется для добавления или удаления MSI из хранилища служб восстановления. Используйте параметр -IdentityType для добавления удостоверения SystemAssigned/UserAssigned в RSVault. Используйте параметр RemoveSystemAssigned/RemoveUserAssigned, чтобы удалить MSI из хранилища. Кроме того, этот командлет можно использовать для настройки параметров хранилища, таких как степень детализации управления затратами, доступ к общедоступной сети, состояние неизменяемости и состояние восстановления между подписками.

Примеры

Пример 1. Добавление удостоверения SystemAssigned в хранилище служб восстановления

Update-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName" -IdentityType SystemAssigned

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

Пример 2. Добавление удостоверения UserAssigned в хранилище служб восстановления

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$identity1 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity1"
$identity2 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity2"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -IdentityType UserAssigned -IdentityId $identity1.Id, $identity2.Id
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type                   : UserAssigned
UserAssignedIdentities : {[/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity1,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity],
                         [/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity2,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity]}

Первый командлет извлекает хранилище служб восстановления. Второй и третий командлет извлекает созданные пользователем MSIs. Четвертый командлет добавляет пользовательские MSIs в хранилище. Пятый командлет показывает удостоверения, добавленные в хранилище.

Пример 3. Удаление удостоверений SystemAssigned и UserAssigned из хранилища

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveSystemAssigned
$AllUserIdentities =  $vault.Identity.UserAssignedIdentities.Keys | ForEach-Object {$_}
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveUserAssigned -IdentityId $AllUserIdentities
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               :
Type                   : None
UserAssignedIdentities :

Первый командлет извлекает хранилище служб восстановления. Второй командлет удаляет удостоверение SystemAssigned из хранилища. Третий командлет извлекает все пользовательские MSIs в виде списка из хранилища. Четвертый командлет удаляет все пользовательские MSIs из хранилища. В случае, если вы хотите, можно указать выбранные удостоверения пользователей, которые будут удалены как разделенные запятыми, как и в предыдущем примере. Пятый командлет показывает удостоверения в хранилище, так как мы удалили все удостоверения, тип отображается как None.

Пример 4. Обновление PublicNetworkAccess, ImmutabilityState хранилища служб восстановления

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -PublicNetworkAccess "Disabled" -ImmutabilityState "Unlocked"
$updatedVault.Properties.PublicNetworkAccess
$updatedVault.Properties.ImmutabilitySettings.ImmutabilityState

Disabled
Unlocked

Первый командлет извлекает хранилище служб восстановления. Второй командлет обновляет свойства PublicNetworkAccess, ImmutabilityState хранилища служб восстановления. Третья и четвертая команда используются для получения доступа к общедоступной сети и неизменяемости состояния хранилища.

Пример 5. Включение и отключение CrossSubscriptionRestore для хранилища служб восстановления

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -CrossSubscriptionRestoreState Disabled
$updatedVault.Properties.RestoreSettings.CrossSubscriptionRestoreSettings.CrossSubscriptionRestoreState

Disabled

Первый командлет извлекает хранилище служб восстановления. Второй командлет обновляет CrossSubscriptionRestoreState хранилища служб восстановления. Третья команда получает состояние восстановления между подписками хранилища.

Пример 6. Обновление CostManagementGranularity для хранилища служб восстановления

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -CostManagementGranularity "VaultLevel"
$updatedVault.Properties.CostManagementSettings.GranularityLevel

VaultLevel

Первый командлет извлекает хранилище служб восстановления. Второй командлет обновляет CostManagementGranularity на "VaultLevel". Допустимые значения: VaultLevel, ProtectedItemLevel и ProtectedItemWithParentTag. Третья команда получает уровень детализации управления затратами хранилища.

Параметры

-Confirm

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

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

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

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

(All)

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

-CostManagementGranularity

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

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

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

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

(All)

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

-CrossSubscriptionRestoreState

Состояние восстановления между подписками хранилища. Допустимые значения: "Включено", "Отключено", "ПостоянноDisabled".

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

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

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

(All)

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

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

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

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

(All)

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

-DisableAzureMonitorAlertsForAllFailoverIssue

Включает или отключает мониторинг оповещений о проблеме отработки отказа в RS-хранилище.

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

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

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

(All)

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

-DisableAzureMonitorAlertsForAllReplicationIssue

Включает или отключает мониторинг оповещений о проблеме репликации в RS-хранилище.

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

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

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

(All)

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

-DisableAzureMonitorAlertsForJobFailure

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

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

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

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

(All)

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

-DisableClassicAlerts

Логический параметр, указывающий, следует ли отключить или включить оповещения резервного копирования из классического решения.

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

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

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

(All)

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

-DisableEmailNotificationsForSiteRecovery

Включает или отключает классические уведомления электронной почты для Site Recovery в RS-хранилище.

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

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

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

(All)

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

-IdentityId

Идентификаторы ARM удостоверения UserAssigned, которые необходимо добавить или удалить. Это разделенный запятыми список идентификаторов удостоверений.

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

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

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

(All)

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

-IdentityType

Тип MSI, назначенный хранилищу служб восстановления.

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

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

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

AzureRSVaultAddMSIdentity

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

-ImmutabilityState

Состояние неизменяемости хранилища. Допустимые значения: "Отключено", "Разблокировано", "Заблокировано". Разблокированные средства включают и могут быть изменены, заблокированы и не могут быть изменены.

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

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

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

(All)

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

-Name

Указывает имя хранилища служб восстановления для обновления.

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

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

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

(All)

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

-PublicNetworkAccess

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

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

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

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

(All)

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

-RemoveSystemAssigned

Укажите этот параметр, чтобы удалить systemAssigned Identity из хранилища.

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

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

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

AzureRSVaultRemoveMSIdentity

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

-RemoveUserAssigned

Укажите этот параметр, чтобы удалить удостоверение UserAssigned из хранилища. Кроме того, укажите параметр IdentityId вместе с этим параметром.

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

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

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

AzureRSVaultRemoveMSIdentity

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

-ResourceGroupName

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

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

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

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

(All)

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

-SecureToken

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

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

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

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

(All)

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

-Token

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

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

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

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

(All)

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

-WhatIf

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

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

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

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

(All)

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

CommonParameters

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

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

String

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

Vault