Unlock-AzDataProtectionResourceGuardOperation

參考

模組:: Az.DataProtection

解除鎖定受資源防護保護的重要作業

語法

Unlock-AzDataProtectionResourceGuardOperation
      -ResourceGroupName <String>
      -VaultName <String>
      [-SubscriptionId <String>]
      [-ResourceGuardOperationRequest <String[]>]
      [-ResourceToBeDeleted <String>]
      [-Token <String>]
      [-SecureToken <SecureString>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

解除鎖定受資源防護保護的重要作業

範例

範例 1：解除鎖定受資源防護保護的重要作業 - 刪除備份實例

$proxy = Get-AzDataProtectionResourceGuardMapping -ResourceGroupName $resourceGroupName -VaultName $vaultName -SubscriptionId $subscriptionId
$operationRequests = $proxy.ResourceGuardOperationDetail.DefaultResourceRequest
$resourceGuardOperationRequest = $operationRequests | Where-Object { $_ -match "deleteBackupInstanceRequests" }

$token = (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx").Token
$instances = Get-AzDataProtectionBackupInstance -SubscriptionId $subscriptionId -ResourceGroupName $resourceGroupName -VaultName $vaultName

$unlock = Unlock-AzDataProtectionResourceGuardOperation -ResourceGroupName $resourceGroupName -SubscriptionId $subscriptionId -VaultName $vault.Name -ResourceGuardOperationRequest $resourceGuardOperationRequest -ResourceToBeDeleted $instances[0].Id -Token $token
$unlock | fl 

Remove-AzDataProtectionBackupInstance -SubscriptionId $subscriptionId -ResourceGroupName $resourceGroupName -VaultName $vaultName  -Name $instances[0].Name

2023-08-28T14:29:17.3982762Z

執行解除鎖定之前，請確定您具有資源防護的參與者存取權。

擷取並傳遞跨租用戶授權令牌，以防資源防護存在於不同的租使用者中。

第一個命令會擷取備份保存庫與資源防護之間的資源防護對應。第二個命令會擷取對應至資源防護所保護之所有重要作業的作業要求。第三個命令會擷取對應於我們想要解除鎖定之作業的作業要求。第四個命令會擷取對應至資源防護租使用者的存取令牌。第五個命令會擷取我們想要停止保護的備份實例。第六個命令會解除鎖定資源防護所保護的刪除備份作業。在解除鎖定之前，請確定具有資源防護的參與者存取權。最後，我們會移除要停用保護的備份實例。

範例 2：使用短手解除鎖定刪除備份實例作業

$token = (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx").Token
$instances = Get-AzDataProtectionBackupInstance -SubscriptionId $subscriptionId -ResourceGroupName $resourceGroupName -VaultName $vaultName

$unlock = Unlock-AzDataProtectionResourceGuardOperation -ResourceGroupName $resourceGroupName -SubscriptionId $subscriptionId -VaultName $vault.Name -ResourceGuardOperationRequest DeleteBackupInstance -ResourceToBeDeleted $instances[0].Id -Token $token
$unlock | fl 

Remove-AzDataProtectionBackupInstance -SubscriptionId $subscriptionId -ResourceGroupName $resourceGroupName -VaultName $vaultName  -Name $instances[0].Name

2023-08-28T14:29:17.3982762Z

範例 1 的快速方式（短手）。在此範例中，我們示範只要將DeleteBackupInstance傳遞至ResourceGuardOperationRequest，就可以執行解除鎖定。我們會傳遞實例 ARM 識別碼作為要刪除的資源。在跨租用戶資源防護的情況下傳遞存取令牌。

範例 3：使用短手解除鎖定停用 MUA 作業

$token = (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx").Token
$proxy = Get-AzDataProtectionResourceGuardMapping -ResourceGroupName $resourceGroupName -VaultName $vaultName -SubscriptionId $subscriptionId

$unlock = Unlock-AzDataProtectionResourceGuardOperation -ResourceGroupName $resourceGroupName -SubscriptionId $subscriptionId -VaultName $vault.Name -ResourceGuardOperationRequest DisableMUA -ResourceToBeDeleted $proxy.Id -Token $token
$unlock | fl 

Remove-AzDataProtectionResourceGuardMapping -ResourceGroupName $resourceGroupName -SubscriptionId $subscriptionId -VaultName $vaultName

2023-08-28T14:29:17.3982762Z

範例 1 的快速方式（短手）。在此範例中，我們示範只要將 DisableMUA 傳遞至 ResourceGuardOperationRequest，就可以執行解除鎖定。我們會傳遞資源防護對應 ARM 識別碼作為要刪除的資源，這會在備份保存庫上停用 MUA。在跨租用戶資源防護的情況下傳遞存取令牌。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

備份保存庫的資源組名

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceGuardOperationRequest

由 resourceGuard 保護且需要解除鎖定的重要作業清單。支援的值為 DeleteBackupInstance、DisableMUA

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceToBeDeleted

需要解除鎖定才能執行關鍵作業的資源 ARM 識別碼

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SecureToken

用來授權受跨租用戶資源防護保護之作業的參數。使用命令（Get-AzAccessToken -TenantId “xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx -AsSecureString”要擷取不同租用戶的授權令牌的令牌。

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

備份保存庫的訂用帳戶標識碼

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Token

用來授權受跨租用戶資源防護保護之作業的參數。使用命令（Get-AzAccessToken -TenantId “xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx -AsSecureString”用來擷取不同租使用者的安全授權令牌，然後使用 ConvertFrom-SecureString Cmdlet 轉換為字串。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VaultName

備份保存庫的名稱

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

String

共用方式為