Azure Storage Mover プロジェクトを管理する

1. Azure portal の [プロジェクト エクスプローラー] ページに移動して、プロジェクトにアクセスします。 既定の [すべてのプロジェクト ] ビューには、プロビジョニングされたプロジェクトの名前と、そのプロジェクトに含まれるジョブの概要が表示されます。

   

2. [ プロジェクトの作成] を選択して、[ プロジェクトの作成 ] ウィンドウを開きます。 [プロジェクト名] フィールドにプロジェクト 名 の値を指定しますが、[ プロジェクトの説明 ] フィールドは空のままにします。 最後に、[ 作成 ] を選択してプロジェクトをプロビジョニングします。

   

プロジェクトを作成するには、名前を決定する必要があります。 リソースの名前付け規則を参照して、サポートされている名前を選びます。 説明は省略可能で、最大 1024 文字の 1 バイト文字を含めることができます。

New-AzStorageMoverProject コマンドレットは、前にデプロイしたストレージ ムーバー リソース内に新しいプロジェクトを作成するために使用されます。 Az.StorageMover モジュールをまだインストールしていない場合:

## 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

詳細については、 Azure PowerShell のインストール に関する記事を参照してください。

必要な -Name、 -ResourceGroupName、および -StorageMoverName パラメーターの値を指定する必要があります。 -Description パラメーターは省略可能です。

1. 長い文字列や複雑な可能性がある文字列を格納するには、変数を作成して使用することをお勧めします。

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

2. Connect-AzAccount コマンドレットを使用して Azure アカウントに接続します。 例に示すように、 -Subscription パラメーターの値を指定して、サブスクリプションの ID を指定します。

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. 接続が正常に完了したら、次の例に示すように、 New-AzStorageMoverProject コマンドレットを使用して新しいプロジェクトを作成できます。

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

   次の応答例には、プロジェクトが正常に作成されたことを示す値を持つ ProvisioningState プロパティが含まれています。

   
   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
   
   

1. Azure portal 内の [プロジェクト エクスプローラー] ページに移動して、使用可能なプロジェクトの一覧を表示します。 フィルターを作成して適用して、ビューを制限または整形できます。 結果の範囲を絞り込むには、引き続きフィルターを追加できます。

   

   次の例に示すように、必要に応じてフィルターを編集または削除することもできます。 現時点では、名前によるプロジェクトのフィルター処理のみがサポートされています。

   

2. プロジェクト エクスプローラー ウィンドウまたは結果一覧から、前のセクションで作成したプロジェクトの名前を選択します。 プロジェクトのプロパティとジョブの概要データが、[詳細] ウィンドウに表示されます。

   プロジェクトに有効な説明がない場合は、[ 説明の追加 ] を選択して [ 説明の編集] ウィンドウを表示します。

   

   説明が存在する場合は、[ 説明 ] 見出しの下に表示されます。 説明の横にある [編集] アイコンまたは [説明の編集] アイコンを選択して、編集ウィンドウを表示します。 次の図は、2 つのアイコンの場所を示しています。

   

3. 編集ウィンドウで、プロジェクトの説明を変更します。 ウィンドウの下部にある [ 保存 ] を選択して変更をコミットします。

   

1. Get-AzStorageMoverProject コマンドレットを使用して、プロジェクト リソースの一覧を取得します。 必要に応じて、 -Name パラメーター値を指定して、特定のプロジェクト リソースを取得できます。 省略可能なパラメーターを指定せずにコマンドレットを呼び出すと、リソース グループ内のすべてのプロビジョニング済みプロジェクトの一覧が返されます。

   次の例では、 demoProject 値を指定して特定のプロジェクト リソースを取得します。

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

   次のサンプル応答には、空の 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. コマンドレットによって返されたプロジェクトに不足している説明を追加するには、 Update-AzStorageMoverProject コマンドレットを使用する必要があります。 ただし、この例では、 -ResourceGroupName、 -StorageMoverName、および -Name パラメーターがすべて必要です。 また、次の例に示すように、不足している Project の説明 値に -Description パラメーターを指定することもできます。

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

   応答に含まれる ProvisioningState は、プロジェクトが正常に更新されたことを確認します。

   
     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
   
   

1. Azure portal の [プロジェクト エクスプローラー] ページに移動して、プロジェクトと、プロジェクトに含まれるジョブの概要を表示します。

   

2. まず、[ プロジェクト エクスプローラー ] ウィンドウまたは結果の一覧で、削除するプロジェクトの名前を選択します。 次に、[ プロジェクト の詳細] ウィンドウから [ プロジェクト の削除] を選択します。 最後に、[ プロジェクトの削除の確認 ] ダイアログで [ 削除 ] を選択して、プロジェクトを完全に削除します。 必要に応じて、次の図で強調表示されている選択範囲を参照してください。

   

Remove-AzStorageMoverProjectを使用して、プロジェクト リソースを完全に削除します。 プロジェクトの名前に -Name パラメーターを指定し、リソース グループとストレージ ムーバーのリソース名に -ResourceGroupName パラメーターと -StorageMoverName パラメーターをそれぞれ指定します。

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