Azure Storage Mover 엔드포인트 관리

1. Azure Portal에서 스토리지 이동기 리소스 페이지로 이동합니다. 탐색 창 내에서 스토리지 엔드포인트를 선택하여 엔드포인트에 액세스합니다.

   

   스토리지 엔드포인트 페이지에서 기본 스토리지 엔드포인트 보기에는 프로비전된 모든 원본 엔드포인트의 이름과 연결된 속성의 요약이 표시됩니다. 대상 엔드포인트를 선택하여 대응하는 대상 엔드포인트를 볼 수 있습니다. 프로토콜 버전이나 호스트 필터를 선택하고 적절한 옵션을 선택하여 결과를 추가로 필터링할 수도 있습니다.

   

2. 엔드포인트 만들기를 선택하여 엔드포인트 유형 메뉴를 확장합니다. 원본 엔드포인트 만들기를 선택하여 다음 이미지와 같이 원본 엔드포인트 만들기 창을 엽니다.

   

3. 원본 엔드포인트 만들기 창에서 필요한 호스트 이름 또는 IP 및 공유 이름 값에 대한 값을 입력합니다. 호스트 이름 또는 IP 주소 값은 IPv4 주소이거나 정규화된 도메인 또는 호스트 이름이어야 합니다.

   Important

   DNS 구성에 따라, 호스트 이름 대신 정규화된 도메인 이름(FQDN)을 사용해야 할 수 있습니다.

   1024자 이하의 선택적 설명 값을 추가할 수도 있습니다. 다음으로 프로토콜 버전을 선택하여 프로토콜 선택 메뉴를 확장하고 원본 대상에 적합한 옵션을 선택합니다.

   스토리지 이동기 에이전트는 Key Vault 내에 저장된 비밀을 사용하여 SMB 엔드포인트에 연결합니다. SMB 원본 엔드포인트를 만들 때는 비밀이 포함된 Key Vault의 이름과 비밀 자체의 이름을 모두 입력해야 합니다.

   먼저 Key Vault를 선택하여 메뉴를 확장하고 비밀을 포함하는 Key Vault의 이름을 선택합니다. 필요한 경우 Key Vault 목록을 필터링할 값을 입력해도 됩니다.

   

   적절한 Key Vault를 선택한 후에는 필요한 사용자 이름용 비밀 선택 및 암호용 비밀 선택 필드에 대한 값을 입력할 수 있습니다. 비밀에 URI를 제공하거나 목록에서 비밀을 선택하면 이러한 값을 제공할 수 있습니다. 비밀 선택 단추를 선택하여 메뉴를 활성화하고 사용자 이름 및 암호 값을 선택합니다. 또는 URI에서 비밀 입력 옵션을 사용하도록 설정하고 사용자 이름 및 암호 비밀에 적절한 URI를 제공할 수도 있습니다.

   호스트 및 공유 이름에 대한 값이 연결되어 전체 마이그레이션 원본 경로를 형성합니다. 경로 값은 전체 원본 경로 필드에 표시됩니다. 제공된 경로를 복사하고 액세스할 수 있는지 확인한 후 변경 내용을 커밋합니다. 마지막으로, 모든 값이 올바르고 원본 경로에 액세스할 수 있는지 확인한 후 만들기를 선택하여 새 엔드포인트를 추가합니다.

   

   다음 예제 이미지와 같이 새 엔드포인트가 배포되고 원본 엔드포인트 목록에 표시됩니다.

   

New-AzStorageMoverSmbEndpoint 및 New-AzStorageMoverNfsEndpoint cmdlet은 이전에 배포한 스토리지 이동기 리소스에서 새 엔드포인트를 만드는 데 사용됩니다.

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. 항상 변수를 만들고 사용하여 길거나 잠재적으로 복잡한 문자열을 저장하는 것이 좋습니다.

   Important

   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 cmdlet을 사용하여 Azure 계정에 로그인합니다. 예제와 같이 -Subscription 매개 변수에 대한 값을 제공하여 구독 ID를 지정합니다.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. 성공적으로 연결되면 새 원본 엔드포인트 리소스를 만들 수 있습니다. 요구 사항에 따라, 다음 예제와 같이 New-AzStorageMoverSmbEndpoint cmdlet을 사용하여 SMB 엔드포인트를 만들 수 있습니다.

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

   또는 예제와 같이 New-AzStorageMoverNfsEndpoint cmdlet을 사용하여 새 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에서 스토리지 이동기 리소스 페이지로 이동합니다. 탐색 창 내에서 스토리지 엔드포인트를 선택하여 엔드포인트에 액세스합니다.

   

   스토리지 엔드포인트 페이지에서 기본 스토리지 엔드포인트 보기에는 프로비전된 모든 원본 엔드포인트의 이름과 연결된 속성의 요약이 표시됩니다. 대상 엔드포인트를 선택하여 기존 대상 엔드포인트를 확인합니다. 스토리지 계정 필터와 적절한 옵션을 선택하여 결과를 추가로 필터링할 수 있습니다.

   

2. 엔드포인트 만들기를 선택하여 엔드포인트 유형 메뉴를 확장합니다. 대상 엔드포인트 만들기를 선택하여 다음 이미지와 같이 대상 엔드포인트 만들기 창을 엽니다.

   

3. 대상 엔드포인트 만들기 창의 구독 및 스토리지 계정 목록에서, 구독 및 대상 스토리지 계정을 각각 선택합니다. 그런 다음 대상 엔드포인트에 해당하는 적절한 대상 유형 옵션을 선택합니다.

   현재 Azure Storage Mover 릴리스는 특정 원본-대상 쌍 조합에 대한 완전한 충실도 마이그레이션을 지원합니다. 지원되는 원본 및 대상의 이점을 활용하려면 항상 최신 에이전트 버전을 사용해야 합니다.

   원본 프로토콜	대상	설명
   SMB 2.x 탑재	Azure 파일 공유(SMB)	SMB 1.x 원본 및 NFS Azure 파일 공유는 현재 지원되지 않습니다.
   NFS 3 및 4 탑재	Azure Blob Storage 컨테이너	"계층 구조 네임스페이스 서비스(HNS)" 기능을 사용하도록 설정한 컨테이너가 지원되며, ADLS Gen2 REST API 집합이 마이그레이션에 사용됩니다.

   선택한 대상 유형에 맞게 해당 드롭다운 목록에서 Blob 컨테이너 또는 파일 공유를 선택합니다. 마지막으로, 대상에 대한 선택적 설명 값을 1024자 이하로 추가하고 만들기를 선택하여 엔드포인트를 배포합니다.

   

다음 예제 이미지와 같이 새 엔드포인트가 배포되고 엔드포인트 목록에 표시됩니다.

1. 새 SMB 파일 공유를 만들려면 다음 예제와 같이 New-AzStorageMoverAzStorageSmbFileShareEndpoint cmdlet을 사용합니다.

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

New-AzStorageMoverAzStorageContainerEndpoint PowerShell cmdlet을 사용하여 새 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 cmdlet을 사용하여 엔드포인트 리소스 목록을 검색합니다. 필요에 따라 -Name 매개 변수 값을 제공하여 특정 리소스를 검색할 수 있습니다. 선택적 매개 변수 없이 cmdlet을 호출하면 스토리지 이동기 리소스와 연결된 모든 프로비저닝된 프로젝트의 목록이 반환됩니다.

   다음 예제에서는 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 cmdlet을 포함하여, 이전 예제에서 반환된 엔드포인트에 누락된 설명을 추가할 수 있습니다. 다음 예제에서는 누락된 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"