Azure Storage Mover エンドポイントの管理

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

   

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

   

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

   

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

   Von Bedeutung

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

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

   ストレージ ムーバー エージェントは、Key Vault 内に格納されているシークレットを使用して SMB エンドポイントに接続します。 SMB ソース エンドポイントを作成するときは、シークレットを含む 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. 長い文字列や複雑な可能性がある文字列を格納するには、変数を作成して使用することをお勧めします。

   Von Bedeutung

   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/demoResourceGroup/"
   $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 リソース ページに移動します。 ナビゲーション ウィンドウ内から [ストレージ エンドポイント ] を選択して、エンドポイントにアクセスします。

   

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

   

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

   

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

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

   ソース プロトコル	目標	コメント
   AWS S3	Azure BLOB コンテナー	Glacier または Glacier Deep Archive ストレージ クラスを含む AWS (Amazon Web Services) S3 バケットは移行できません。
   SMB 2.x および 3.x プロトコルのマウント	Azure ファイル共有 (SMB)	SMB 1.x ソースと NFS Azure ファイル共有は、現在サポートされていません。
   SMB 2.x および 3.x プロトコルのマウント	Azure BLOB コンテナー	フラットネームスペース (FNS) と階層型名前空間サービス (HNS) 機能が有効になっているコンテナーがサポートされ、ADLS Gen2 REST API セットが移行に使用されます。
   NFS 3 および NFS 4 マウント	Azure BLOB コンテナー	フラットネームスペース (FNS) と階層型名前空間サービス (HNS) 機能が有効になっているコンテナーがサポートされ、ADLS Gen2 REST API セットが移行に使用されます。
   NFS 3 および NFS 4 マウント	Azure ファイル共有 (NFS 4.1)	NFS Azure ファイル共有は NFS v3/4 ソースでサポートされています

   選択したターゲットの種類に応じて、対応するドロップダウン リストから 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. [ ストレージ エンドポイント ] ページの既定の [ストレージ エンドポイント ] ビューには、プロビジョニングされたソース エンドポイントの名前と、関連するプロパティの概要が表示されます。 プロビジョニングされた宛先エンドポイントを表示するには、[ ターゲット エンドポイント] を選択します。 [プロトコル] または [ホスト] フィルターと関連するオプションを選択して、結果をさらにフィルター処理できます。

   

現時点では、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"