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

Description

리소스 그룹에 속하는 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

이 명령은 백업 자격 증명 모음에 대한 모든 작업 실패에 대한 모니터 경고를 사용하지 않도록 설정합니다. 허용되는 값은 Enabled, Disabled입니다. 기본적으로 이 설정은 사용하도록 설정되어 있습니다.

예제 3: 자격 증명 모음 ImmutabilityState, 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: UserAssignedManagedIdentity에서 SystemAssignedManagedIdentity 및 CmkEncryptionKeyUri로 자격 증명 모음 CmkIdentityType 업데이트

$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(사용자 할당 관리 ID)를 할당하도록 자격 증명 모음 업데이트

$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(사용자 할당 관리 ID) 개체에 대한 해시 테이블을 만듭니다. 이 개체는 UAMI 리소스 ID를 UserAssignedIdentity의 새 인스턴스에 매핑합니다. 다음으로 Update-AzDataProtectionBackupVault cmdlet을 사용하여 시스템 할당 관리 ID를 유지하면서 백업 자격 증명 모음에 UAMI를 할당합니다. -IdentityType 매개 변수는 SystemAssigned 및 UserAssigned ID가 모두 사용되도록 지정합니다.

매개 변수

-AsJob

작업으로 명령 실행

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

-AzureMonitorAlertsForAllJobFailure

작업 실패에 대한 기본 제공 Azure Monitor 경고를 사용하거나 사용하지 않도록 설정하는 매개 변수입니다. 보안 경고를 사용하지 않도록 설정할 수 없습니다.

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

-CmkEncryptionKeyUri

암호화에 사용할 CMK 키의 키 URI입니다. 키 자동 회전을 사용하도록 설정하려면 키 URI에서 버전 구성 요소를 제외합니다.

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

-CmkEncryptionState

Backup 자격 증명 모음에 CMK 암호화 상태를 사용하도록 설정합니다.

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

-CmkIdentityType

CMK 암호화에 사용할 ID 형식( SystemAssigned 또는 UserAssigned IDENTITy)입니다.

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

-CmkUserAssignedIdentityId

ID 형식이 UserAssigned인 경우 이 매개 변수가 필요합니다. Key Vault에 대한 액세스 권한이 있는 사용할 사용자 할당 관리 ID ID를 추가합니다.

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

-Confirm

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

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

-CrossRegionRestoreState

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

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

-CrossSubscriptionRestoreState

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

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

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

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

-EncryptionSetting

리소스의 고객 관리형 키 세부 정보입니다. 생성하려면 ENCRYPTIONSETTING 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-IdentityType

SystemAssigned, UserAssigned, 'SystemAssigned, UserAssigned' 또는 None일 수 있는 identityType

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

-IdentityUserAssignedIdentity

사용자 할당 ID를 가져오거나 설정합니다.

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

-ImmutabilityState

자격 증명 모음의 불변성 상태입니다. 허용되는 값은 사용 안 함, 잠금 해제됨, 잠김입니다.

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

-InputObject

생성할 ID 매개 변수는 INPUTOBJECT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:	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

LAC 검사를 수행할 ResourceGuardOperationRequests

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

-SecureToken

교차 테넌트 리소스 보호로 보호되는 작업에 권한을 부여하는 매개 변수입니다. 명령(Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -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

대상 구독의 ID입니다. 값은 UUID여야 합니다.

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

-Tag

리소스 태그.

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

-Token

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

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

-VaultName

백업 자격 증명 모음의 이름입니다.

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

-WhatIf

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

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

입력

IDataProtectionIdentity

출력

IBackupVaultResource

다음을 통해 공유