Rövid útmutató: Tárolási feladat létrehozása, hozzárendelése és futtatása a PowerShell használatával

Ebben a rövid útmutatóban megtudhatja, hogyan hozhat létre egy tárolási feladatot az Azure PowerShell használatával, és hogyan rendelheti hozzá egy Azure Storage-fiókhoz. Ezután áttekintheti a futtatás eredményeit. A tárolási feladat időalapú megváltoztathatatlansági szabályzatot alkalmaz a tárfiókban található Microsoft Word-dokumentumokra.

Előfeltételek

• Egy Azure-előfizetés. Tekintse meg a fiók ingyenes létrehozását.

• Egy Azure-tárfiók. Lásd : tárfiók létrehozása. A fiók létrehozásakor győződjön meg arról, hogy engedélyezi a verziószintű nem módosíthatóság támogatását, és hogy nem engedélyezi a hierarchikus névtér funkciót.

  A nyilvános környezetben csak olyan tárfiókokat célozhat meg, amelyek ugyanabban a régióban találhatók, mint a tárolási feladatok.

• A Storage Blob Data Owner szerepkör a tárfiók vagy erőforráscsoport kontextusában van hozzárendelve a felhasználói identitáshoz.

• A felhasználói identitáshoz rendelt egyéni szerepkör az erőforráscsoport környezetében, amely tartalmazza a tevékenység tárfiókhoz rendeléséhez szükséges RBAC-műveleteket. Tekintse meg a tevékenység hozzárendeléséhez szükséges engedélyeket.

• .NET-keretrendszer 4.7.2 vagy újabb verzió van telepítve. További információ: .NET-keretrendszer letöltése.

• PowerShell-verzió 5.1 vagy újabb.

A PowerShell-modul telepítése

1. Győződjön meg arról, hogy telepítve van a PowerShellGet legújabb verziója.

   Install-Module PowerShellGet -Repository PSGallery -Force
   

2. Zárja be, majd nyissa meg újra a PowerShell-konzolt.

3. Telepítse az Az.Storage PowerShell-modul 7.1.1-es vagy újabb verzióját. Előfordulhat, hogy el kell távolítania a PowerShell-modul más verzióit. Az Azure PowerShell telepítéséről további információt az Azure PowerShell telepítése a PowerShellGet használatával című témakörben talál.

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

4. Telepítse Az.StorageAction modult.

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

   További információ a PowerShell-modulok telepítéséről: Az Azure PowerShell-modul telepítése

Jelentkezzen be az Azure-fiókjába

1. Nyisson meg egy Windows PowerShell-parancsablakot, majd jelentkezzen be az Azure-fiókjába a Connect-AzAccount paranccsal, és kövesse a képernyőn megjelenő utasításokat.

   Connect-AzAccount
   

2. Ha identitása egynél több előfizetéshez van társítva, és a rendszer nem kéri az előfizetés kiválasztását, állítsa be az aktív előfizetést a használni kívánt tárfiók előfizetésére. Ebben a példában cserélje le a <subscription-id> helyőrző értékét az előfizetés azonosítójára.

   Select-AzSubscription -SubscriptionId <subscription-id>
   

Tárolási feladat létrehozása

1. Feltétel definiálása JSON használatával. A feltétel egy vagy több záradék gyűjteménye. Minden záradék tartalmaz egy tulajdonságot, egy értéket és egy operátort. A következő JSON-ban a tulajdonság Nameaz , az érték .docx, az operátor pedig az endsWith. Ez a záradék csak Microsoft Word-dokumentumokon engedélyezi a műveleteket.

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

   A tulajdonságok és operátorok teljes listáját a Tárolási feladat feltételei című témakörben találja.

   Jótanács

   Több feltételt is hozzáadhat ugyanahhoz a sztringhez, és vesszővel elválaszthatja őket.

2. Az egyes műveletek definiálása a New-AzStorageActionTaskOperationObject parancs használatával.

   Az alábbi művelet létrehoz egy olyan műveletet, amely módosíthatatlansági szabályzatot állít be.

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

   Az alábbi művelet egy blobindexcímkét állít be egy Word-dokumentum metaadataiban.

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

3. Hozzon létre egy tárolási feladatot a New-AzStorageActionTask parancs használatával, és adja meg a korábban meghatározott feltételeket és műveleteket. Ez a példa létrehoz egy mystoragetask nevű tárolási feladatot az mystoragetaskresourcegroup erőforráscsoportban az USA nyugati régiójában.

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

Hozzárendelés létrehozása

A tárfeladat-hozzárendelés egy tárfiókot határoz meg. A tárolási feladat engedélyezése után a rendszer alkalmazza a feladat feltételeit és műveleteit az adott tárfiókra. A hozzárendelés olyan konfigurációs tulajdonságokat is tartalmaz, amelyek segítenek az adott blobok megcélzásában, vagy megadják, hogy mikor és milyen gyakran fut a feladat. Minden megcélzni kívánt fiókhoz hozzáadhat hozzárendelést.

1. Hozzon létre egy tárfeladat-hozzárendelést a New-AzStorageTaskAssignment parancs használatával. Az alábbi hozzárendelés egy mycontainer nevű fiók mystorageaccounttárolóját célozza meg. Ez a hozzárendelés azt határozza meg, hogy a feladat csak egyszer fusson, és a végrehajtási jelentéseket egy nevű storage-tasks-reportmappába menti. A feladat ütemezése szerint 10 perccel a jelenlegi időponttól lesz futtatva.

   $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. Adjon engedélyt a tárolási feladatnak a céltárfiókon végzett műveletek végrehajtásához. A Storage Blob Data Owner parancs használatával rendelje hozzá a New-AzRoleAssignment szerepkört a tárolási feladat kezelés alá tartozó rendszeridentitásához.

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

Feladatfuttatás eredményeinek megtekintése

Miután a feladat befejeződött, a parancs használatával lekérheti az egyes hozzárendelések futtatási jelentésének összegzését Get-AzStorageActionTasksReport .

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

Az SummaryReportPath egyes jelentések összegzésének mezője egy részletes jelentés elérési útját tartalmazza. A jelentés vesszővel tagolt listát tartalmaz a tárolóról, a blobról és a végrehajtott műveletről, valamint egy állapotról.

Erőforrások tisztítása

Távolítsa el az összes létrehozott elemet. Az adategységek eltávolításának legegyszerűbb módja az erőforráscsoport törlése. Az erőforráscsoport törlésével a csoportban található összes erőforrást is törli. A következő példában az erőforráscsoport eltávolítása eltávolítja a tárfiókot és magát az erőforráscsoportot is.

Remove-AzResourceGroup -Name $ResourceGroup 

Következő lépések

Tárolási feladat létrehozása

A Microsoft Azure PowerShell Storage-műveletek parancsmagjaira vonatkozó referencia

• Tárolási PowerShell-parancsmagok