快速入門:使用 PowerShell 建立、指派及執行記憶體工作

在這個快速入門中,你將學習如何使用 Azure PowerShell 建立儲存任務,將其指派到 Azure 儲存體 帳號執行,並檢視執行結果。 此範例將基於時間的不可變性政策套用於儲存帳號中存在的任何 Microsoft Word 文件。

先決條件

  • Azure 訂用帳戶。 請參閱 免費建立帳戶。

  • 一個 Azure 儲存體帳戶。 請參閱 建立記憶體帳戶。 此範例也需要版本層級的不可變性支援,以設定 blob 的不可變性政策。

    目前,你只能指派任務到與儲存任務相同區域的儲存帳號上執行。

  • 儲存體 Blob 資料擁有者角色會指派給儲存體帳戶或資源群組內容中的使用者身分識別。

  • 資源群組內容中指派給使用者身分識別的自訂角色,其中包含將工作指派給儲存體帳戶所需的 RBAC 動作。 請參閱 指派工作所需的許可權。

  • 已安裝 .NET Framework 4.7.2 或更高版本。 如需詳細資訊,請參閱下載 .NET Framework。

  • PowerShell 5.1 版或更高版本。

安裝 PowerShell 模組

  1. 確保你安裝的是最新版本的PowerShellGet。

    Install-Module PowerShellGet -Repository PSGallery -Force
    
  2. 關閉然後重新開啟 PowerShell 控制台。

  3. 安裝 Az.Storage PowerShell 模組的 7.1.1 版或更新版本。 您必須解除安裝其他版本的 PowerShell 模組。 如需如何安裝 Azure PowerShell 的詳細資訊,請參閱使用 PowerShellGet 安裝 Azure PowerShell。

    Install-Module Az.Storage -Repository PsGallery -RequiredVersion 7.1.1-preview -AllowClobber -AllowPrerelease -Force
    
  4. 安裝 Az.StorageAction 模組。

    Install-Module -Name Az.StorageAction -Repository PSGallery -Force 
    

    如需如何安裝 PowerShell 模組的詳細資訊,請參閱安裝 Azure PowerShell 模組

登入您的 Azure 帳戶

  1. 開啟 Windows PowerShell 命令視窗,然後使用 命令登入您的 Azure 帳戶 Connect-AzAccount ,並遵循螢幕上的指示。

    Connect-AzAccount
    
  2. 如果你的身份綁定了多個訂閱,且 PowerShell 沒有提示你選擇訂閱,請將你的有效訂閱設為你想使用的儲存帳號的訂閱。 在此範例中,使用訂用帳戶識別碼取代 <subscription-id> 預留位置值。

    Select-AzSubscription -SubscriptionId <subscription-id>
    

建立儲存任務

  1. 使用 JSON 定義 條件 。 條件是由一個或多個子句組成的邏輯謂詞。 每個子句都包含屬性、值和運算子。 在下列 JSON 中,屬性為 Name,值為 .docx,而運算子為 endsWith。 這個子句只允許對 Microsoft Word 文件進行操作。

    $conditions = "[[endsWith(Name, '.docx')]]"
    

    如需屬性和運算子的完整清單,請參閱 記憶體工作條件。

    小提示

    您可以將多個條件新增至相同的字串,並以逗號分隔它們。

  2. 使用 New-AzStorageActionTaskOperationObject 命令定義每個作業。

    下列操作會建立一個新的操作,該操作會設定不變性原則。

    $policyoperation = New-AzStorageActionTaskOperationObject `
    -Name SetBlobImmutabilityPolicy `
    -Parameter @{"untilDate" = (Get-Date).AddDays(1); "mode" = "locked"} `
    -OnFailure break `
    -OnSuccess continue
    
    

    下列作業會在 Word 檔的元數據中設定 Blob 索引標記。

    $tagoperation = New-AzStorageActionTaskOperationObject -Name SetBlobTags `
    -Parameter @{"tagsetImmutabilityUpdatedBy"="StorageTaskQuickstart"} `
    -OnFailure break `
    -OnSuccess continue
    
  3. 使用 New-AzStorageActionTask 命令建立存儲任務,並傳入您稍早定義的條件和操作。 此範例會在美國西部區域的資源群組mystoragetask中建立名為 quickstartresourcegroup 的記憶體工作。

    $task = New-AzStorageActionTask `
    -Name mystoragetask `
    -ResourceGroupName quickstartresourcegroup `
    -Location westus `
    -Enabled `
    -Description 'my powershell storage task' `
    -IfCondition $conditions `
    -IfOperation $policyoperation,$tagoperation `
    -EnableSystemAssignedIdentity:$true
    

建立指派

儲存體工作指派會指定要執行該工作的儲存體帳戶。 它包含執行設定,幫助你鎖定特定 blob,並指定任務執行的時間與頻率。 你必須為每個你想讓任務執行的儲存帳號新增任務指派。

  1. 使用 New-AzStorageTaskAssignment 命令建立記憶體工作指派。 下列指派以帳戶名為 mycontainer 的容器 mystorageaccount 為目標。 此指派指定任務只執行一次,並將執行報告儲存在 blob 容器 storage-tasks-report中。 工作排程設定為從目前時間起 10 分鐘後開始。

    $startTime = (Get-Date).AddMinutes(10)   
    
    New-AzStorageTaskAssignment `
    -ResourceGroupName quickstartresourcegroup `
    -AccountName mystorageaccount `
    -name mystoragetaskAssignment `
    -TaskId $task.Id `
    -ReportPrefix "storage-tasks-report" `
    -TriggerType RunOnce `
    -StartOn $startTime.ToUniversalTime() `
    -Description "task assignment" `
    -Enabled:$true `
    -TargetPrefix "mycontainer/"
    
  2. 授與記憶體工作許可權,以在目標記憶體帳戶上執行作業。 使用 Storage Blob Data Owner 命令,將 New-AzRoleAssignment 的角色指派給儲存體工作的系統指派受控識別。

    New-AzRoleAssignment `
    -ResourceGroupName quickstartresourcegroup `
    -ResourceName mystorageaccount `
    -ResourceType "Microsoft.Storage/storageAccounts" `
    -ObjectId $task.IdentityPrincipalId  `
    -RoleDefinitionName "Storage Blob Data Owner"
    

檢視工作執行的結果

任務執行結束後,使用 Get-AzStorageActionTasksReport 指令取得每個指派的執行報告摘要。

Get-AzStorageActionTasksReport `
-ResourceGroupName quickstartresourcegroup `
-StorageTaskName mystoragetask | Format-List

每個報告摘要的 SummaryReportPath 欄位包含通往詳細執行報告的路徑。 報告使用 CSV 格式,擷取每個處理的物件,包括 blob 容器、blob 名稱、執行的操作及操作結果。

清理資源

刪除你建立的所有資源。 在這個快速入門中,你在同一資源群組中建立了儲存帳號和儲存任務。 刪除這個資源群組會移除所有這些資源。

Remove-AzResourceGroup -Name $ResourceGroup 

後續步驟

建立儲存任務

Microsoft Azure PowerShell 儲存體動作 Cmdlet 參考