Azure Storage Mover エンドポイントを管理する

1. Azure portal で、お使いの Storage Mover リソース ページに移動します。 ナビゲーション ウィンドウ内から Storage エンドポイントを選択して、エンドポイントにアクセスします。

   

   [ストレージ エンドポイント] ページの既定の Storage エンドポイント ビューには、プロビジョニングされたソース エンドポイントの名前と、関連するプロパティの概要が表示されます。 [ターゲット エンドポイント] を選択して、対応する移行先エンドポイントを表示できます。 また、[プロトコル バージョン] フィルターまたは [ホスト] フィルターを選択し、適切なオプションを選択して、結果をさらにフィルター処理することもできます。

   

2. [エンドポイントの作成] を選択して、[エンドポイントの種類] メニューを展開します。 次の図に示すように、[ソース エンドポイントの作成] を選択して [ソース エンドポイントの作成] ウィンドウを開きます。

   

3. [ソース エンドポイントの作成] ウィンドウで、必要な [ホスト名または IP] の値と [共有名] の値を指定します。 [ホスト名または IP アドレス] の値は、IPv4 アドレス、または完全修飾ドメインまたはホスト名でなければなりません。

   重要

   DNS の構成によっては、ホスト名ではなく完全修飾ドメイン名 (FQDN) を使用する必要がある場合があります。

   また、最大 1024 文字の Description 値 (省略可能) を追加することもできます。 次に、[プロトコル バージョン] を選択してプロトコル選択メニューを展開し、ソースとターゲットに適したオプションを選択します。

   ストレージ ムーバー エージェントは、Key Vault 内に格納されているシークレットを使用して SMB エンドポイントに接続します。 SMB ソース エンドポイントを作成する際に、シークレットを含む Key Vault の名前とシークレット自体の名前の両方を指定する必要があります。

   まず、[Key Vault] を選択してメニューを展開し、シークレットを格納している Key Vault の名前を選択します。 必要に応じて、Key Vault の一覧をフィルター処理する値を指定できます。

   

   適切な Key Vault を選択したら、ユーザー名に必要な [シークレットの選択] フィールドと [パスワード のシークレットの選択] フィールドの値を指定できます。 これらの値を指定するには、シークレットの URI を指定するか、一覧からシークレットを選択します。 [シークレットの選択] ボタンを選択してメニューを有効にし、ユーザー名の値とパスワードの値を選択します。 または、[URI からシークレットを入力する] オプションを有効にして、ユーザー名とパスワードのシークレットの適切な URI を指定することもできます。

   ホストと共有名の値が連結され、完全な移行ソース パスが形成されます。 [完全なソース パス] フィールドにパスの値が表示されます。 表示されたパスをコピーし、変更をコミットする前にアクセスできることを確認します。 最後に、すべての値が正しく、ソース パスにアクセスできることを確認したら、[作成] を選択して新しいエンドポイントを追加します。

   

   次のサンプル イメージに示すように、新しいエンドポイントがデプロイされ、ソース エンドポイントの一覧に表示されます。

   

New-AzStorageMoverSmbEndpoint および New-AzStorageMoverNfsEndpoint のコマンドレットは、以前にデプロイしたストレージ ムーバー リソース内に新しいエンドポイントを作成するために使用されます。

モジュールをインストール 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 のインストールの詳細については、「Azure PowerShell のインストール」に関する記事を参照してください。

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

   重要

   DNS の構成によっては、ホスト名ではなく完全修飾ドメイン名 (FQDN) を使用する必要がある場合があります。

   サンプル コード ブロックをコピーし、必要なパラメーターの値を指定します。 -Description パラメーターは省略可能であり、[エンドポイントのプロパティの表示と編集] セクションに追加されます。

   
   ## Set variables
   $subscriptionID    = "[Subscription GUID]"
   $resourceGroupName = "[Resource group name]"
   $storageMoverName  = "[Storage mover resource's name]"
   $sourceHost        = "[Source share's host name or IP address]"
   $sourceShare       = "[Source share's name]"
   $targetResourceID  = "/subscriptions/[GUID]/resourceGroups/demoResrouceGroup/"
   $targetResourceID += "providers/Microsoft.Storage/storageAccounts/demoAccount"
   
   ## For SMB endpoints 
   $smbFileshare      = "[Target fileshare name]"
   $usernameURI       = "https://demo.vault.azure.net/secrets/demoUser"
   $passwordURI       = "https://demo.vault.azure.net/secrets/demoPassword"
   
   ## For NFS endpoints
   $nfsContainer      = "[Blob container target]"
   
   

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

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. 正常に接続されたら、新しいソース エンドポイントのリソースを作成できます。 要件に応じて、次の例に示すように、New-AzStorageMoverSmbEndpoint コマンドレットを使用して SMB エンドポイントを作成できます。

   
   New-AzStorageMoverSmbEndpoint `
      -Name "smbSourceEndpoint"
      -ResourceGroupName $resourceGroupName `
      -StorageMoverName $storageMoverName `
      -Host $sourceHost ` 
      -ShareName $sourceShare `
      -CredentialsUsernameUri $usernameURI `
      -CredentialsPasswordUri $passwordURI
   
   

   または、次に示すように、New-AzStorageMoverNfsEndpoint コマンドレットを使用して新しい NFS ソース エンドポイントを作成することもできます。

   
   New-AzStorageMoverNfsEndpoint `
       -Name "nfsSourceEndpoint" `
       -ResourceGroupName $resourceGroupName `
       -StorageMoverName $storageMoverName `
       -Host $sourceHost `
       -Export $sourceShare `
   
   

   次の応答例には、エンドポイントが正常に作成されたことを示す値をもつ ProvisioningState プロパティが含まれています。

   
   Id                           : /subscriptions/<GUID>/resourceGroups/
                                 demoResourceGroup/providers/Microsoft.StorageMover/
                                 storageMovers/demoMover/endpoints/smbTargetEndpoint
   Name                         : demoTarget
   Property                     : {
                                    "endpointType": "AzureStorageSmbFileShare",
                                    "description": "",
                                    "provisioningState": "Succeeded",
                                    "storageAccountResourceId": "/subscriptions/[GUID]/
                                     resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                     storageAccounts/contosoeuap",
                                    "fileShareName": "demoFileshare"
                                  }
   SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
   SystemDataCreatedBy          : user@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
   SystemDataLastModifiedBy     : user@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : microsoft.storagemover/storagemovers/endpoints
   
   

1. Azure portal で、お使いの Storage Mover リソース ページに移動します。 ナビゲーション ウィンドウ内から Storage エンドポイントを選択して、エンドポイントにアクセスします。

   

   [ストレージ エンドポイント] ページの既定の Storage エンドポイント ビューには、プロビジョニングされたソース エンドポイントの名前と、関連するプロパティの概要が表示されます。 [ターゲット エンドポイント] を選択して、既存の移行先エンドポイントを表示します。 [ストレージ アカウント] フィルターと適切なオプションを選択して、結果をさらにフィルター処理できます。

   

2. [エンドポイントの作成] を選択して、[エンドポイントの種類] メニューを展開します。 次の図に示すように、[ターゲット エンドポイントの作成] を選択して [ターゲット エンドポイントの作成] ウィンドウを開きます。

   

3. [ターゲット エンドポイントの作成] ウィンドウで [サブスクリプション] と [ストレージ アカウント] の一覧から、サブスクリプションと移行先ストレージ アカウントをそれぞれ選択します。 次に、ターゲット エンドポイントに対応する適切な [ターゲットの種類] オプションを選択します。

   現在の Azure Storage Mover リリースでは、特定のソースとターゲットのペアの組み合わせに対して、完全に忠実な移行がサポートされています。 常に最新のエージェント バージョンを利用して、サポートされている次のソースと宛先のメリットを活用してください。

   ソース プロトコル	移行先	Comments
   S MB (メガバイト) 2.x マウント	Azure ファイル共有 (S MB (メガバイト))	現在、S MB (メガバイト) 1.x ソースと NFS Azure ファイル共有はサポートされていません。
   NFS 3 と 4 マウント	Azure BLOB Storage コンテナー	"階層型名前空間サービス (HNS)" 機能が有効になっているコンテナーがサポートされ、ADLS Gen2 REST API セットが移行に使用されます。

   選択したターゲットの種類に応じて、対応するドロップダウン リストから [BLOB コンテナー] または [ファイル共有] を選択します。 最後に、最大 1024 文字の長さのターゲットにオプションの Description 値を追加し、[作成] を選択してエンドポイントをデプロイできます。

   

次のサンプル イメージに示すように、新しいエンドポイントがデプロイされ、エンドポイントの一覧に表示されます。

1. 新しい SMB ファイル共有を作成するには、次の例に示すように、New-AzStorageMoverAzStorageSmbFileShareEndpoint コマンドレットを使用します。

New-AzStorageMoverAzStorageSmbFileShareEndpoint `
   -Name "smbTargetEndpoint" ` 
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName ` 
   -StorageAccountResourceId $targetResourceID `
   -FileShareName $targetFileshare

New-AzStorageMoverAzStorageContainerEndpoint PowerShell コマンドレットを使用して、新しい NFS BLOB コンテナーを作成します。 次の例は、プロビジョニング のガイダンスを示しています。

New-AzStorageMoverAzStorageContainerEndpoint `
  -Name "nfsTargetEndpoint" `
  -ResourceGroupName $resourceGroupName `
  -StorageMoverName $storageMoverName `
  -BlobContainerName $targetEpContainer `
  -StorageAccountResourceId $targetResourceID `

次の応答例には、エンドポイントが正常に作成されたことを示す値をもつ ProvisioningState プロパティが含まれています。

Id                           : /subscriptions/<GUID>/resourceGroups/
                              demoResourceGroup/providers/Microsoft.StorageMover/
                              storageMovers/demoMover/endpoints/smbTargetEndpoint
Name                         : demoTarget
Property                     : {
                                 "endpointType": "AzureStorageSmbFileShare",
                                 "description": "",
                                 "provisioningState": "Succeeded",
                                 "storageAccountResourceId": "/subscriptions/[GUID]/
                                  resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                  storageAccounts/contosoeuap",
                                 "fileShareName": "demoFileshare"
                               }
SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
SystemDataCreatedBy          : user@contoso.com
SystemDataCreatedByType      : User
SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
SystemDataLastModifiedBy     : user@contoso.com
SystemDataLastModifiedByType : User
Type                         : microsoft.storagemover/storagemovers/endpoints

1. Azure portal に移動し、[ストレージ ムーバー] リソース ページに移動します。 サンプル イメージに示すように、ナビゲーション ウィンドウ内から [ストレージ エンドポイント] を選択して、エンドポイントにアクセスします。

   

2. [ストレージ エンドポイント] ページの既定の Storage エンドポイント ビューには、プロビジョニングされたソース エンドポイントの名前と、関連するプロパティの概要が表示されます。 プロビジョニングされた移行先エンドポイントを表示するには、[ターゲット エンドポイント] を選択します。 [プロトコル] フィルターまたは [ホスト] フィルターと関連するオプションを選択して、結果をさらにフィルター処理できます。

   

現時点では、Azure portal では、プロビジョニングされたエンドポイントの直接の変更はサポートされていません。 ただし、エンドポイントの説明は、次のこの例に従って Azure PowerShell を使用して変更できます。 Azure portal 内で更新が必要なエンドポイント リソースは、削除して再作成する必要があります。

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

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

   
     Get-AzStorageMoverEndpoint `
       -ResourceGroupName $resourceGroupName `
       -StorageMoverName $storageMoverName ` 
       -Name "demoTarget" 
   
   

   応答のサンプルには、空の Description プロパティを含む指定されたプロジェクトのプロパティが含まれています。

   
   Id                           : /subscriptions/<GUID>/resourceGroups/
                                    demoResourceGroup/providers/Microsoft.StorageMover/
                                    storageMovers/demoMover/endpoints/smbTargetEndpoint
   Name                         : demoTarget
   Property                     : {
                                    "endpointType": "AzureStorageSmbFileShare",
                                    "description": "",
                                    "provisioningState": "Succeeded",
                                    "storageAccountResourceId": "/subscriptions/[GUID]/
                                     resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                     storageAccounts/contosoeuap",
                                    "fileShareName": "demoFileshare"
                                  }
   SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
   SystemDataCreatedBy          : user@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
   SystemDataLastModifiedBy     : user@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : microsoft.storagemover/storagemovers/endpoints
   
   

2. パイプライン演算子と Update-AzStorageMoverAzStorageSmbFileShareEndpoint コマンドレットを含めることで、前の例で返されたエンドポイントでは不足している説明を追加できます。 次の例では、不足している [SMB ファイル共有エンドポイント] の値を -Description パラメーターを使用して入力しています。

   
     Get-AzStorageMoverEndpoint `
       -ResourceGroupName $resourceGroupName `
       -StorageMoverName $storageMoverName ` 
       -Name "demoTarget" | `
     Update-AzStorageMoverAzStorageSmbFileShareEndpoint `
       -Description "SMB fileshare endpoint"
   
   

   応答には、更新された Description プロパティ値が含まれるようになりました。

   
   Id                           : /subscriptions/<GUID>/resourceGroups/
                                    demoResourceGroup/providers/Microsoft.StorageMover/
                                    storageMovers/demoMover/endpoints/smbTargetEndpoint
   Name                         : demoTarget
   Property                     : {
                                    "endpointType": "AzureStorageSmbFileShare",
                                    "description": "SMB fileshare endpoint",
                                    "provisioningState": "Succeeded",
                                    "storageAccountResourceId": "/subscriptions/[GUID]/
                                     resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                     storageAccounts/contosoeuap",
                                    "fileShareName": "demoFileshare"
                                  }
   SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
   SystemDataCreatedBy          : user@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
   SystemDataLastModifiedBy     : user@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : microsoft.storagemover/storagemovers/endpoints
   
   

1. Azure portal を使用してエンドポイントを削除するには、[ストレージ ムーバー] リソース ページに移動します。 次の図に示すように、ナビゲーション ウィンドウ内から [ストレージ エンドポイント] を選択して、エンドポイントにアクセスします。

   

2. 既定の [ソース エンドポイント] ビューには、プロビジョニングされたソース エンドポイントの名前と、関連するデータの概要が表示されます。 [宛先エンドポイント] フィルターを選択して、対応する宛先エンドポイントを表示できます。

   削除するエンドポイントの名前を見つけて、対応するチェック ボックスをオンにします。 適切なエンドポイントを選択したことを確認したら、次の図に示すように [削除] を選択します。

   

   次のサンプル イメージに示すように、新しいエンドポイントが削除され、エンドポイントの一覧に表示されなくなります。

   

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

Remove-AzStorageMoverEndpoint `
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName ` 
   -Name "demoTarget"