Update-AzRecoveryServicesVault

참조

모듈:: Az.RecoveryServices

MSIdentity를 복구 서비스 자격 증명 모음으로 업데이트합니다.

구문

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

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

Description

이 cmdlet은 복구 서비스 자격 증명 모음에서 MSI를 추가하거나 제거하는 데 사용됩니다. -IdentityType 매개 변수를 사용하여 SystemAssigned/UserAssigned ID를 RSVault에 추가합니다. RemoveSystemAssigned/RemoveUserAssigned 스위치를 사용하여 자격 증명 모음에서 MSI를 제거합니다.

예제

예제 1: Recovery Services 자격 증명 모음에 SystemAssigned ID 추가

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

이 cmdlet은 복구 서비스 자격 증명 모음에 SystemAssigned ID를 추가하는 데 사용됩니다.

예제 2: Recovery Services 자격 증명 모음에 UserAssigned ID 추가

$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]}

첫 번째 cmdlet은 복구 서비스 자격 증명 모음을 가져옵니다. 두 번째 및 세 번째 cmdlet은 사용자가 만든 MSI를 가져옵니다. 네 번째 cmdlet은 자격 증명 모음에 사용자 MSI를 추가합니다. 다섯 번째 cmdlet은 자격 증명 모음에 추가된 ID를 보여 줍니다.

예제 3: 자격 증명 모음에서 SystemAssigned 및 UserAssigned ID 제거

$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 :

첫 번째 cmdlet은 복구 서비스 자격 증명 모음을 가져옵니다. 두 번째 cmdlet은 자격 증명 모음에서 SystemAssigned ID를 제거합니다. 세 번째 cmdlet은 모든 사용자 MSI를 자격 증명 모음에서 목록으로 가져옵니다. 네 번째 cmdlet은 자격 증명 모음에서 모든 사용자 MSI를 제거합니다. 원하는 경우 이전 예제와 같이 선택한 사용자 ID를 쉼표로 구분하여 제거할 수 있습니다. 다섯 번째 cmdlet은 자격 증명 모음의 ID를 보여 줍니다. 모든 ID를 제거하면 Type이 None으로 표시됩니다.

예제 4: Recovery Services 자격 증명 모음의 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

첫 번째 cmdlet은 복구 서비스 자격 증명 모음을 가져옵니다. 두 번째 cmdlet은 복구 서비스 자격 증명 모음의 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

첫 번째 cmdlet은 복구 서비스 자격 증명 모음을 가져옵니다. 두 번째 cmdlet은 복구 서비스 자격 증명 모음의 CrossSubscriptionRestoreState를 업데이트합니다. 세 번째 명령은 자격 증명 모음의 구독 간 복원 상태를 가져옵니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CrossSubscriptionRestoreState

자격 증명 모음의 구독 간 복원 상태입니다. 허용되는 값은 "Enabled", "Disabled", "PermanentlyDisabled"입니다.

형식:	Nullable<T>[CrossSubscriptionRestoreState]
허용되는 값:	Enabled, Disabled, PermanentlyDisabled
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableAzureMonitorAlertsForJobFailure

부울 매개 변수는 모든 작업 실패에 대해 기본 제공 Azure Monitor 경고를 수신해야 하는지 여부를 지정합니다.

형식:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableClassicAlerts

클래식 솔루션의 백업 경고를 사용하지 않도록 설정할지 아니면 사용하도록 설정해야 하는지를 지정하는 부울 매개 변수입니다.

형식:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IdentityId

추가/제거할 UserAssigned ID의 ARM ID입니다. ID ID의 쉼표로 구분된 목록입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IdentityType

Recovery Services 자격 증명 모음에 할당된 MSI 유형입니다.

형식:	MSIdentity
허용되는 값:	SystemAssigned, None, UserAssigned
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImmutabilityState

자격 증명 모음의 불변성 상태입니다. 허용되는 값은 "Disabled", "Unlocked", "Locked"입니다. 잠금 해제됨은 사용 및 변경 가능을 의미하며, 잠금은 사용됨을 의미하며 변경할 수 없습니다.

형식:	Nullable<T>[ImmutabilityState]
허용되는 값:	Disabled, Unlocked, Locked
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

업데이트할 복구 서비스 자격 증명 모음의 이름을 지정합니다.

형식:	String
Position:	2
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PublicNetworkAccess

자격 증명 모음의 공용 네트워크 액세스를 사용/사용하지 않도록 설정하는 매개 변수입니다. 이 설정은 프라이빗 엔드포인트에 유용합니다.

형식:	Nullable<T>[PublicNetworkAccess]
허용되는 값:	Enabled, Disabled
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RemoveSystemAssigned

자격 증명 모음에서 SystemAssigned ID를 제거하려면 이 스위치를 제공합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RemoveUserAssigned

자격 증명 모음에서 UserAssigned ID를 제거하려면 이 스위치를 제공합니다. 또한 이 스위치와 함께 IdenityId 매개 변수를 제공합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

Recovery Services 자격 증명 모음이 있는 Azure 리소스 그룹의 이름을 지정합니다.

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Token

교차 테넌트 리소스 보호로 보호되는 작업에 권한을 부여하는 매개 변수입니다. 명령(Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")를 사용합니다. 다른 테넌트에 대한 권한 부여 토큰을 가져오는 토큰

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

출력

Vault

다음을 통해 공유