Hantera Azure Storage Mover-projekt

Ett Storage Mover-projekt används för att organisera migreringsjobb i logiska uppgifter eller komponenter. Ett projekt innehåller minst en jobbdefinition, som i sin tur beskriver varje datakälla och målslutpunkt för projektet. Artikeln Förstå resurshierarkin i Storage Mover innehåller mer detaljerad information om relationen mellan en Storage Mover och dess projekt.

När du definierar ett projekt är det en bra idé att lägga till alla relaterade, mellanberoende datakällor i samma projekt så att de kan migreras tillsammans. Du bör lägga till alla datakällor som krävs för att migrera en enskild arbetsbelastning i stället för att skapa projekt för varje datakälla i din migreringsplan. Du kan också välja att skapa enskilda projekt för varje enskild grupp med datakällor i din migreringsplan.

Den här artikeln beskriver hur du skapar och hanterar Azure Storage Mover-projekt. Om du vill följa de här exemplen behöver du en lagringsflyttarresurs på den översta nivån. Om du inte har skapat någon ännu följer du stegen i artikeln Skapa en lagringsflyttare innan du fortsätter.

När du har slutfört stegen i den här artikeln kan du skapa och hantera projekt med hjälp av Azure-portalen och Azure PowerShell.

Skapa ett projekt

Det första steget när du definierar ett migreringsjobb är att skapa en projektresurs. När projektet har skapats kan du lägga till käll- och målslutpunkter för datakällan. I det här exemplet lämnar du avsiktligt beskrivningsfältet tomt. Du lägger sedan till den i avsnittet Visa och redigerar ett projekts egenskaper senare i den här artikeln.

Viktigt!

Om du ännu inte har distribuerat en resurs med hjälp av resursprovidern måste du skapa resursen på den översta nivån.

Varning

Det går inte att byta namn på projektresurser. Det är en bra idé att se till att du har namngett projektet på rätt sätt eftersom du inte kan ändra projektnamnet när det har etablerats.

Azure-portalen

1. Gå till sidan Projektutforskaren i Azure-portalen för att få åtkomst till dina projekt. I vyn Alla projekt visas namnen på alla etablerade projekt och en sammanfattning av de jobb som de innehåller.

   

2. Välj Skapa projekt för att öppna fönstret Skapa ett projekt . Ange ett projektnamnvärde i fältet Projektnamn , men lämna fältet Projektbeskrivning tomt. Slutligen väljer du Skapa för att etablera projektet.

   

PowerShell

När du skapar ett projekt måste du bestämma ett namn. Se namngivningskonventionen för resurser för att välja ett namn som stöds. En beskrivning är valfri och kan innehålla upp till 1 024 enbytestecken.

Cmdleten New-AzStorageMoverProject används för att skapa ett nytt projekt i en lagringsflyttarresurs som du tidigare distribuerade. Om du inte har installerat modulen Az.StorageMover ännu:

## Ensure you are running the latest version of PowerShell 7
$PSVersionTable.PSVersion

## Your local execution policy must be set to at least remote signed or less restrictive
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

## If you don't have the general Az PowerShell module, install it first
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

## Lastly, the Az.StorageMover module is not installed by default and must be manually requested.
Install-Module -Name Az.StorageMover -Scope CurrentUser -Repository PSGallery -Force

Artikeln Installera Azure PowerShell innehåller mer information.

Du måste ange värden för de obligatoriska -Nameparametrarna , -ResourceGroupNameoch -StorageMoverName . Parametern -Description är valfri.

1. Det är alltid en bra idé att skapa och använda variabler för att lagra långa eller potentiellt komplexa strängar.

   
   ## Set variables
   $subscriptionID     = "Your subscription ID GUID"
   $resourceGroupName  = "demoResourceGroup"
   $storageMoverName   = "demoMover"
   $projectName        = "demoProject"
   $projectDescription = ""
   
   

2. Anslut till ditt Azure-konto med hjälp av cmdletenConnect-AzAccount. Ange ID:t för din prenumeration genom att ange ett värde för parametern -Subscription enligt exemplet.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. När du har anslutit kan du använda cmdleten New-AzStorageMoverProject för att skapa ditt nya projekt enligt följande exempel.

   
   New-AzStorageMoverProject `
      -ResourceGroupName $resourceGroupName `
      -StorageMoverName $storageMoverName `
      -Name $projectName `
      -Description $projectDescription
   
   

   Följande exempelsvar innehåller egenskapen ProvisioningState vars värde anger att projektet har skapats.

   
   Description                  : This is a project used for demonstration.
   Id                           : /subscriptions/<GUID>/resourceGroups/
                                 demoResourceGroup/providers/Microsoft.StorageMover/storageMovers/
                                 demoMover/projects/demoProject
   Name                         : testingAgain
   ProvisioningState            : Succeeded
   SystemDataCreatedAt          : 8/17/2022 1:19:00 AM
   SystemDataCreatedBy          : user@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 8/17/2022 1:19:00 AM
   SystemDataLastModifiedBy     : user@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : microsoft.storagemover/storagemovers/projects
   
   

Visa och redigera ett projekts egenskaper

Beroende på ditt användningsfall kan du behöva hämta ett specifikt projekt eller en fullständig lista över alla projektresurser. Du kan också behöva lägga till eller redigera en projektbeskrivning.

Följ stegen i det här avsnittet om du vill visa projekt som är tillgängliga för din Storage Mover-resurs.

Azure-portalen

1. Gå till sidan Projektutforskaren i Azure-portalen för att visa en lista över tillgängliga projekt. Du kan skapa och använda filter för att begränsa eller forma vyn. Om du vill begränsa resultatets omfattning kan du fortsätta att lägga till fler filter.

   

   Filter kan också redigeras eller tas bort efter behov enligt exemplet nedan. För närvarande stöds endast filtrering av projekt efter namn.

   

2. I projektutforskarens fönster eller i resultatlistan väljer du namnet på projektet som skapades i föregående avsnitt. Projektets egenskaper och jobbsammanfattningsdata visas i informationsfönstret.

   Om projektet saknar en giltig beskrivning väljer du Lägg till beskrivning för att visa fönstret Redigera beskrivning .

   

   Om det finns en beskrivning visas den under rubriken Beskrivning . Välj antingen ikonen Redigera bredvid beskrivningen eller ikonen Redigera beskrivning för att visa redigeringsfönstret. Bilden nedan visar platsen för de två ikonerna.

   

3. Ändra beskrivningen för projektet i redigeringsfönstret. Välj Spara längst ned i fönstret för att checka in ändringarna.

   

PowerShell

1. Använd cmdleten Get-AzStorageMoverProject för att hämta en lista över projektresurser. Du kan också ange ett -Name parametervärde för att hämta en specifik projektresurs. Om du anropar cmdleten utan den valfria parametern returneras en lista över alla etablerade projekt i resursgruppen.

   I följande exempel hämtas en specifik projektresurs genom att värdet demoProject anges.

   
     Get-AzStorageMoverProject `
       -ResourceGroupName $resourceGroupName `
       -StorageMoverName $storageMoverName `
       -Name "demoProject" 
   
   

   Exempelsvaret nedan innehåller det angivna projektets egenskaper, inklusive det tomma Description.

   
      Description                  :
      Id                           : /subscriptions/<GUID>/resourceGroups/
                                     demoResourceGroup/providers/Microsoft.StorageMover/storageMovers/
                                     demoMover/projects/demoProject
      Name                         : demoProject
      ProvisioningState            : Succeeded
      SystemDataCreatedAt          : 7/15/2022 6:22:51 PM
      SystemDataCreatedBy          : user@contoso.com
      SystemDataCreatedByType      : User
      SystemDataLastModifiedAt     : 8/16/2022 10:36:52 PM
      SystemDataLastModifiedBy     : user@contoso.com
      SystemDataLastModifiedByType : User
      Type                         : microsoft.storagemover/storagemovers/projects   
   
   

2. Om du vill lägga till beskrivningen som saknas i projektet som returneras av cmdleten måste du använda cmdleten Update-AzStorageMoverProject . I det här fallet krävs dock parametrarna -ResourceGroupName, -StorageMoverNameoch -Name . Du vill också ange värdet för den projektbeskrivning som saknas med parametern -Description enligt följande exempel.

   
   Update-AzStorageMoverProject `
      -Name demoProject `
      -ResourceGroupName $resourceGroupName `
      -StorageMoverName $storageMoverName `
      -Description "Demo project managed with PowerShell."
   
   

   Det ProvisioningState som ingår i svaret bekräftar att projektet har uppdaterats.

   
     Description                  : Demo project managed with PowerShell.
     Id                           : /subscriptions/<GUID>/resourceGroups/
                                     demoResourceGroup/providers/Microsoft.StorageMover/storageMovers/
                                     demoMover/projects/demoProject
     Name                         : demoProject
     ProvisioningState            : Succeeded
     SystemDataCreatedAt          : 7/15/2022 6:22:51 PM
     SystemDataCreatedBy          : user@contoso.com
     SystemDataCreatedByType      : User
     SystemDataLastModifiedAt     : 8/24/2022 7:47:50 AM
     SystemDataLastModifiedBy     : user@contoso.com
     SystemDataLastModifiedByType : User
     Type                         : microsoft.storagemover/storagemovers/projects
   
   

Ta bort projektet

Borttagningen av en projektresurs bör vara relativt sällsynt i produktionsmiljön, även om det kan finnas tillfällen då det kan vara till hjälp. Följ exemplet för att ta bort en Storage Mover-projektresurs.

Varning

Att ta bort ett projekt är en permanent åtgärd och kan inte ångras. Det är en bra idé att se till att du är beredd att ta bort projektet eftersom du inte kommer att kunna återställa det vid ett senare tillfälle.

Azure-portalen

1. Gå till sidan Projektutforskaren i Azure-portalen för att visa dina projekt och en sammanfattning av de jobb som de innehåller.

   

2. Välj först namnet på det projekt som du vill ta bort i fönstret Projektutforskaren eller i resultatlistan. Välj sedan Ta bort projekt i fönstret Projektinformation . Slutligen väljer du Ta bort i dialogrutan Bekräfta projektborttagning för att ta bort projektet permanent. Se de markerade valen i följande bild om det behövs.

   

Varning

Om du tar bort ett projekt tas alla inneslutna jobbdefinitioner, deras körningshistorik och resultat bort. Att ta bort någon av dessa resurser är permanent och kan inte ångras. Lagringsslutpunkter påverkas inte.

PowerShell

Remove-AzStorageMoverProject Använd för att permanent ta bort en projektresurs. Ange projektets namn med parametern -Name samt resursgruppens och lagringsflyttarens resursnamn med -ResourceGroupName -StorageMoverName respektive parametrar.

Remove-AzStorageMoverProject `
   -Name $projectName `
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName

Varning

Om du tar bort ett projekt tas alla inneslutna jobbdefinitioner, deras körningshistorik och resultat bort. Att ta bort någon av dessa resurser är permanent och kan inte ångras. Lagringsslutpunkter påverkas inte.

Nästa steg

När dina projekt har skapats kan du börja arbeta med jobbdefinitioner.

Definiera ett migreringsjobb