Rozpoczęcie pracy: tworzenie, przypisywanie oraz uruchamianie zadania dotyczącego przechowywania danych za pomocą programu PowerShell

Z tego przewodnika Szybki start dowiesz się, jak za pomocą programu Azure PowerShell utworzyć zadanie magazynu i przypisać je do konta usługi Azure Storage. Następnie przejrzysz wyniki przebiegu. Zadanie związane z magazynowaniem stosuje politykę niezmienności opartą na czasie na wszystkich dokumentach programu Microsoft Word znajdujących się na koncie magazynowym.

Wymagania wstępne

• Subskrypcja platformy Azure. Zobacz Tworzenie konta bezpłatnie.

• Konto usługi Azure Storage. Zobacz Tworzenie konta magazynu. Podczas tworzenia konta upewnij się, że włączono obsługę niezmienności na poziomie wersji i że nie włączono funkcji hierarchicznej przestrzeni nazw.

  W publicznej wersji można kierować tylko konta magazynu, które znajdują się w tym samym regionie co zadania magazynu.

• Rola Właściciel danych obiektu blob usługi Storage jest przypisywana do tożsamości użytkownika w kontekście konta magazynu lub grupy zasobów.

• Niestandardowa rola przypisana do tożsamości użytkownika w kontekście grupy zasobów zawierająca akcje RBAC, które są niezbędne do przypisania zadania do konta magazynowego. Zobacz Uprawnienia wymagane do przypisania zadania.

• Program .NET Framework jest zainstalowany w wersji 4.7.2 lub nowszej. Aby uzyskać więcej informacji, zobacz Pobieranie programu .NET Framework.

• Wersja programu PowerShell lub nowsza 5.1 .

Zainstaluj moduł programu PowerShell

1. Upewnij się, że masz zainstalowaną najnowszą wersję modułu PowerShellGet.

   Install-Module PowerShellGet -Repository PSGallery -Force
   

2. Zamknij, a następnie otwórz ponownie konsolę programu PowerShell.

3. Zainstaluj wersję 7.1.1-preview lub nowsząmodułu Az.Storage PowerShell. Może być konieczne odinstalowanie innych wersji modułu programu PowerShell. Aby uzyskać więcej informacji na temat instalowania programu Azure PowerShell, zobacz Instalowanie programu Azure PowerShell przy użyciu modułu PowerShellGet.

   Install-Module Az.Storage -Repository PsGallery -RequiredVersion 7.1.1-preview -AllowClobber -AllowPrerelease -Force
   

4. Zainstaluj moduł Az.StorageAction .

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

   Aby uzyskać więcej informacji na temat sposobu instalowania modułów programu PowerShell, zobacz Instalowanie modułu programu Azure PowerShell

Zaloguj się do swojego konta platformy Azure

1. Otwórz okno polecenia programu Windows PowerShell, a następnie zaloguj się do konta platformy Azure za Connect-AzAccount pomocą polecenia i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Connect-AzAccount
   

2. Jeśli twoja tożsamość jest skojarzona z więcej niż jedną subskrypcją i nie zostaniesz poproszony o wybranie subskrypcji, ustaw swoją aktywną subskrypcję na subskrypcję konta magazynowego, na którym chcesz pracować. W tym przykładzie zamień symbol zastępczy <subscription-id> na identyfikator swojej subskrypcji.

   Select-AzSubscription -SubscriptionId <subscription-id>
   

Utwórz zadanie magazynu

1. Zdefiniuj warunek przy użyciu formatu JSON. Warunek jest zbiorem jednej lub więcej klauzul. Każda klauzula zawiera właściwość, wartość i operator. W poniższym kodzie JSON właściwość to Name, wartość to .docx, a operator to endsWith. Ta klauzula umożliwia wykonywanie operacji tylko w dokumentach programu Microsoft Word.

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

   Aby uzyskać pełną listę właściwości i operatorów, zobacz Warunki zadania przechowywania.

   Wskazówka

   Możesz dodać wiele warunków do tego samego ciągu i oddzielić je przecinkami.

2. Zdefiniuj każdą operację za pomocą polecenia New-AzStorageActionTaskOperationObject.

   Poniższa operacja tworzy operację, która ustawia zasady niezmienności.

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

   Poniższa operacja ustawia tag indeksu obiektów blob w metadanych dokumentu programu Word.

   $tagoperation = New-AzStorageActionTaskOperationObject -Name SetBlobTags `
   -Parameter @{"tagsetImmutabilityUpdatedBy"="StorageTaskQuickstart"} `
   -OnFailure break `
   -OnSuccess continue
   

3. Utwórz zadanie magazynowania przy użyciu polecenia New-AzStorageActionTask, i przekaż wcześniej zdefiniowane warunki oraz operacje. W tym przykładzie jest tworzone zadanie magazynu o nazwie mystoragetask w grupie zasobów mystoragetaskresourcegroup w regionie Zachodniego USA.

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

Utwórz zadanie

Zadanie magazynowania przypisuje konto magazynu. Po włączeniu zadania magazynu warunki i operacje zadania zostaną zastosowane do tego konta magazynu. Przypisanie zawiera również właściwości konfiguracji, które pomagają w określeniu konkretnych obiektów blob, lub w ustaleniu, kiedy i jak często zadanie ma być uruchamiane. Możesz dodać przypisanie dla każdego konta, które ma być docelowe.

1. Utwórz przypisanie zadania magazynu, używając polecenia New-AzStorageTaskAssignment. Następujące przypisanie jest przeznaczone dla mycontainer kontenera konta o nazwie mystorageaccount. To przypisanie określa, że zadanie zostanie uruchomione tylko raz i zapisze raporty wykonywania w folderze o nazwie storage-tasks-report. Zadanie jest zaplanowane do uruchomienia 10 minut od chwili obecnej.

   $startTime = (Get-Date).AddMinutes(10)   
   
   New-AzStorageTaskAssignment `
   -ResourceGroupName mystoragetaskresourcegroup `
   -AccountName mystorageaccount `
   -name mystoragetaskAssignment `
   -TaskId $task.Id `
   -ReportPrefix "storage-tasks-report" `
   -TriggerType RunOnce `
   -StartOn $startTime.ToUniversalTime() `
   -Description "task assignment" `
   -Enabled:$true `
   -TargetPrefix "mycontainer/"
   

2. Nadaj zadaniu przechowywania uprawnienie do wykonywania operacji na docelowym koncie przechowywania. Przypisz rolę Storage Blob Data Owner do systemowo przypisanej tożsamości zarządzanej zadania magazynu, używając polecenia New-AzRoleAssignment.

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

Wyświetlanie wyników przebiegu zadania

Po zakończeniu wykonywania zadania, przy użyciu polecenia Get-AzStorageActionTasksReport, pobierz podsumowanie raportu przebiegu dla każdego zadania.

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

Pole SummaryReportPath każdego podsumowania raportu zawiera ścieżkę do szczegółowego raportu. Ten raport zawiera listę rozdzieloną przecinkami z kontenerem, obiektem blob i wykonaną operacją wraz ze statusem.

Uprzątnij zasoby

Usuń wszystkie utworzone zasoby. Najprostszym sposobem usunięcia elementów zawartości jest usunięcie grupy zasobów. Usunięcie grupy zasobów spowoduje także usunięcie wszystkich zasobów uwzględnionych w tej grupie. W poniższym przykładzie usunięcie grupy zasobów powoduje usunięcie konta magazynu i samej grupy zasobów.

Remove-AzResourceGroup -Name $ResourceGroup 

Dalsze kroki

Utwórz zadanie magazynowe

Odnośnik dokumentacji poleceń cmdlet dotyczących akcji magazynu programu Microsoft Azure PowerShell

• Cmdlety PowerShell do obsługi magazynowania