다음을 통해 공유


Update-AzDataProtectionBackupInstance

지정된 백업 인스턴스를 업데이트합니다.

구문

Update-AzDataProtectionBackupInstance
      -ResourceGroupName <String>
      -VaultName <String>
      -BackupInstanceName <String>
      [-SubscriptionId <String>]
      [-PolicyId <String>]
      [-UseSystemAssignedIdentity <Boolean>]
      [-UserAssignedIdentityArmId <String>]
      [-VaultedBackupContainer <String[]>]
      [-ResourceGuardOperationRequest <String[]>]
      [-Token <String>]
      [-SecureToken <SecureString>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

지정된 백업 인스턴스를 업데이트합니다.

예제

예제 1: Blob 백업 인스턴스 자격 증명 모음 정책 및 컨테이너 목록 업데이트

$instance = Search-AzDataProtectionBackupInstanceInAzGraph -Subscription $subscriptionId -ResourceGroup $resourceGroupName -Vault $vaultName -DatasourceType AzureBlob
$updatePolicy = Get-AzDataProtectionBackupPolicy -SubscriptionId $subscriptionId -VaultName $vaultName -ResourceGroupName $resourceGroupName| Where-Object { $_.name -eq "vaulted-policy" }
$backedUpContainers = $instance.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList
$updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName $resourceGroupName -VaultName $vaultName -BackupInstanceName $instance.Name -SubscriptionId $subscriptionId -PolicyId $updatePolicy.Id -VaultedBackupContainer $backedUpContainers[0,2,4]
$updateBI.Property.PolicyInfo.PolicyId
$updateBI.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList

/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rgName/providers/Microsoft.DataProtection/backupVaults/vaultName/backupPolicies/vaulted-policy
updatedContainer1
updatedContainer2
updatedContainer3

첫 번째 명령은 업데이트해야 하는 백업 인스턴스를 가져옵니다. 두 번째 명령은 Backup 인스턴스에서 업데이트해야 하는 이름 자격 증명 모음 정책이 있는 백업 정책을 가져옵니다. 세 번째 명령은 현재 백업 자격 증명 모음에 백업된 자격 증명 모음 컨테이너 목록을 가져옵니다. 네 번째 명령은 백업 인스턴스를 새 정책 및 새 컨테이너 목록(현재 기존 백업 컨테이너의 하위 집합)으로 업데이트합니다. 다섯 번째 및 여섯 번째 명령은 백유 인스턴스의 업데이트된 정책 및 컨테이너 목록을 보여 줍니다.

예제 2: Backup 인스턴스에서 UAMI 업데이트

$bi = Get-AzDataProtectionBackupInstance -ResourceGroupName "myResourceGroup" -VaultName "myBackupVault" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

$updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName "myResourceGroup" -VaultName "myBackupVault" -BackupInstanceName $bi.Name -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -UserAssignedIdentityArmId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUami" -UseSystemAssignedIdentity $false

Name                                                   BackupInstanceName
----                                                   ------------------
psDiskBI-psDiskBI-81234567-6171-4d88-ada3-ec1fc5e6c027 psDiskBI-psDiskBI-81234567-6171-4d88-ada3-ec1fc5e6c027

첫 번째 명령은 업데이트해야 하는 백업 인스턴스를 가져옵니다. 두 번째 명령은 새 UAMI(사용자 할당 관리 ID)로 백업 인스턴스를 업데이트하고 시스템 할당 ID의 사용을 사용하지 않도록 설정합니다.

매개 변수

-AsJob

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

-BackupInstanceName

보호된 백업 인스턴스의 고유 이름

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

-Confirm

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

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

-DefaultProfile

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

-NoWait

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

-PolicyId

백업 인스턴스와 연결할 정책의 ID

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

-ResourceGroupName

백업 자격 증명 모음의 리소스 그룹

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

-ResourceGuardOperationRequest

<ResourceGuard-ARMID>/dppModifyPolicy/default와 유사한 형식의 리소스 보호 작업 요청입니다. 작업이 MUA로 보호되는 경우 이 매개 변수를 사용합니다.

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

-SubscriptionId

자격 증명 모음의 구독 ID

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

-Token

교차 테넌트 리소스 보호로 보호되는 작업에 권한을 부여하는 매개 변수입니다. 명령(Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -AsSecureString")을 사용합니다. 다른 테넌트에 대한 보안 권한 부여 토큰을 가져온 다음 ConvertFrom-SecureString cmdlet을 사용하여 문자열로 변환하는 토큰입니다.

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

-UserAssignedIdentityArmId

사용자 할당 ID ARM ID

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

-UseSystemAssignedIdentity

시스템 할당 ID 사용

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

-VaultedBackupContainer

VaultStore 내에서 백업할 컨테이너 목록입니다. DatasourceType AzureBlob에 이 매개 변수를 사용합니다.

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

출력

IBackupInstanceResource