Zarządzanie punktami końcowymi usługi Azure Storage Mover

1. W portalu Azure przejdź do strony zasobu mover Storage. Wybierz pozycję Punkty końcowe magazynu w okienku nawigacji, aby uzyskać dostęp do punktów końcowych.

   

   Na stronie Punkty końcowe usługi Storage domyślny widok Punkty końcowe usługi Storage wyświetla nazwy wszystkich aprowizowanych punktów końcowych źródłowych i podsumowanie skojarzonych z nimi właściwości. Możesz wybrać docelowe punkty końcowe, aby je wyświetlić. Wyniki można również filtrować dalej, wybierając opcję Wersja protokołu lub Filtr hosta i wybierając odpowiednią opcję.

   

2. Wybierz pozycję Utwórz punkt końcowy , aby rozwinąć menu Typ punktu końcowego . Wybierz pozycję Utwórz źródłowy punkt końcowy , aby otworzyć okienko Utwórz źródłowy punkt końcowy , jak pokazano na poniższej ilustracji.

   

3. W okienku Tworzenie źródłowego punktu końcowego podaj wartości wymaganych wartości Nazwa hosta lub Adres IP i Nazwa udziału . Wartość nazwy hosta lub adresu IP musi być adresem IPv4 lub w pełni kwalifikowaną nazwą domeny lub hosta.

   Ważne

   W zależności od konfiguracji DNS może być konieczne użycie w pełni kwalifikowanej nazwy domeny (FQDN) zamiast nazwy hosta.

   Możesz również dodać opcjonalną wartość opisową o długości do 1024 znaków. Następnie wybierz pozycję Wersja protokołu , aby rozwinąć menu wyboru protokołu i wybrać odpowiednią opcję dla źródła docelowego.

   Agenci transferu danych używają tajemnic przechowywanych w Key Vault do połączenia z punktami końcowymi SMB. Podczas tworzenia punktu końcowego źródłowego protokołu SMB należy podać zarówno nazwę usługi Key Vault zawierającą wpisy tajne, jak i nazwy samych wpisów tajnych.

   Najpierw wybierz Magazyn kluczy, aby rozwinąć menu i wybrać nazwę Magazynu kluczy zawierającego twoje tajemnice. W razie potrzeby możesz podać wartość, za pomocą której można filtrować listę magazynów kluczy.

   

   Po wybraniu odpowiedniej usługi Key Vault możesz podać wartości wymaganego pola Wybierz wpis tajny dla nazwy użytkownika i Wybierz wpis tajny dla pól haseł . Te wartości można podać, podając identyfikator URI do wpisów tajnych lub wybierając wpisy tajne z listy. Wybierz przycisk Wybierz wpis tajny , aby włączyć menu i wybrać wartości nazwy użytkownika i hasła. Alternatywnie możesz włączyć opcję Wprowadź tajemnicę z identyfikatora URI i podać odpowiedni identyfikator URI dla nazwy użytkownika i hasła tajemnicy.

   Wartości nazwy hosta i udziału są łączone w celu utworzenia pełnej ścieżki źródłowej migracji. Wartość ścieżki jest wyświetlana w polu Pełna ścieżka źródłowa . Skopiuj podaną ścieżkę i sprawdź, czy możesz uzyskać do niej dostęp przed zatwierdzeniem zmian. Na koniec po potwierdzeniu, że wszystkie wartości są poprawne i że można uzyskać dostęp do ścieżki źródłowej, wybierz pozycję Utwórz , aby dodać nowy punkt końcowy.

   

   Nowy punkt końcowy został wdrożony i teraz pojawia się na liście źródłowych punktów końcowych, jak pokazano na poniższym przykładzie ilustracyjnym.

   

Polecenia New-AzStorageMoverSmbEndpoint i New-AzStorageMoverNfsEndpoint są używane do utworzenia nowego punktu końcowego w ramach wcześniej wdrożonego zasobu do przenoszenia danych w magazynie.

Jeśli nie zainstalowałeś modułu 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

Aby uzyskać więcej informacji na temat instalowania programu Azure PowerShell, zobacz artykuł Instalowanie programu Azure PowerShell .

1. Zawsze dobrym pomysłem jest utworzenie zmiennych i użycie ich do przechowywania długich lub potencjalnie złożonych ciągów.

   Ważne

   W zależności od konfiguracji DNS może być konieczne użycie w pełni kwalifikowanej nazwy domeny (FQDN) zamiast nazwy hosta.

   Skopiuj przykładowy blok kodu i podaj wartości wymaganych parametrów. Parametr -Description jest opcjonalny i jest dodawany w sekcji Wyświetl i edytuj właściwości punktu końcowego .

   
   ## 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. Połącz się z kontem Azure przy użyciu cmdlet Connect-AzAccount. Określ identyfikator subskrypcji, podając wartość parametru -Subscription , jak pokazano w przykładzie.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. Po pomyślnym nawiązaniu połączenia możesz utworzyć nowe źródłowe zasoby punktu końcowego. W zależności od wymagań możesz użyć polecenia cmdlet New-AzStorageMoverSmbEndpoint, aby utworzyć punkt końcowy SMB, jak pokazano w poniższym przykładzie.

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

   Alternatywnie możesz utworzyć nowy źródłowy punkt końcowy systemu plików NFS przy użyciu New-AzStorageMoverNfsEndpoint polecenia cmdlet, jak pokazano poniżej.

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

   Następująca przykładowa odpowiedź zawiera ProvisioningState właściwość , która wskazuje, że punkt końcowy został pomyślnie utworzony.

   
   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. W portalu Azure przejdź do strony zasobu mover Storage. Wybierz pozycję Punkty końcowe magazynu w okienku nawigacji, aby uzyskać dostęp do punktów końcowych.

   

   Na stronie Punkty końcowe usługi Storage domyślny widok Punkty końcowe usługi Storage wyświetla nazwy wszystkich aprowizowanych punktów końcowych źródłowych i podsumowanie skojarzonych z nimi właściwości. Wybierz pozycję Docelowe punkty końcowe , aby wyświetlić istniejące docelowe punkty końcowe. Wyniki można filtrować dalej, wybierając filtr Konta magazynu i odpowiednią opcję.

   

2. Wybierz pozycję Utwórz punkt końcowy , aby rozwinąć menu Typ punktu końcowego . Wybierz Utwórz docelowy punkt końcowy, aby otworzyć okienko Utwórz docelowy punkt końcowy, jak pokazano na poniższej ilustracji.

   

3. W okienku Tworzenie docelowego punktu końcowego wybierz odpowiednio subskrypcję i docelowe konto magazynu z listy Subskrypcja i Konto magazynu . Następnie wybierz odpowiednią opcję Typ docelowy odpowiadającą do punktu końcowego.

   Bieżąca wersja usługi Azure Storage Mover obsługuje migracje pełnej wierności dla określonych kombinacji par źródłowych docelowych. Zawsze korzystaj z najnowszej wersji agenta, aby korzystać z tych obsługiwanych źródeł i miejsc docelowych:

   Protokół źródłowy	Cel	Komentarze
   AWS S3	Kontener obiektów Blob platformy Azure	Nie można migrować kubłów S3 AWS (Amazon Web Services) używających klas magazynu Glacier lub Glacier Deep Archive.
   Instalacja SMB 2.x i 3.x	Udział plików platformy Azure (SMB)	Źródła SMB 1.x i udziały plików platformy Azure NFS nie są obecnie obsługiwane.
   Instalacja SMB 2.x i 3.x	Kontener obiektów Blob platformy Azure	Kontenery z włączoną funkcją Flatnamespace (FNS) i hierarchiczną usługą przestrzeni nazw (HNS) są obsługiwane, a zestaw interfejsu API REST usługi ADLS Gen2 jest używany do migracji.
   Instalacja systemu plików NFS 3 i 4	Kontener obiektów Blob platformy Azure	Kontenery z włączoną funkcją Flatnamespace (FNS) i hierarchiczną usługą przestrzeni nazw (HNS) są obsługiwane, a zestaw interfejsu API REST usługi ADLS Gen2 jest używany do migracji.
   Instalacja systemu plików NFS 3 i 4	Udział plików platformy Azure (NFS 4.1)	Udziały plików Azure obsługujące NFS są zgodne z protokołami NFS w wersjach 3/4.

   W zależności od wybranego typu docelowego wybierz kontener obiektów blob lub udział plików z odpowiedniej listy rozwijanej. Na koniec możesz dodać opcjonalną wartość Opis dla celu o długości do 1024 znaków i wybrać pozycję Utwórz , aby wdrożyć punkt końcowy.

   

Nowy punkt końcowy zostanie wdrożony, a teraz pojawi się na liście punktów końcowych, jak pokazano na poniższym przykładowym obrazie.

1. Aby utworzyć nowy udział plików SMB, użyj polecenia cmdlet New-AzStorageMoverAzStorageSmbFileShareEndpoint, jak pokazano w poniższym przykładzie.

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

New-AzStorageMoverAzStorageContainerEndpoint Użyj polecenia cmdlet programu PowerShell, aby utworzyć nowy kontener obiektów blob NFS. Poniższy przykład zawiera wskazówki dotyczące dostarczania zasobów.

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

Następująca przykładowa odpowiedź zawiera ProvisioningState właściwość , która wskazuje, że punkt końcowy został pomyślnie utworzony.

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. Aby utworzyć punkt końcowy przy użyciu portalu Azure, przejdź na stronę zasobu Storage Mover. Wybierz pozycję Punkty końcowe magazynu w okienku nawigacji, aby uzyskać dostęp do swoich punktów końcowych, jak pokazano na przykładzie obrazu.

   

2. Na stronie Punkty końcowe usługi Storage domyślny widok Punkty końcowe usługi Storage wyświetla nazwy wszystkich aprowizowanych punktów końcowych źródłowych i podsumowanie skojarzonych z nimi właściwości. Aby wyświetlić aprowizowany docelowy punkt końcowy, wybierz pozycję Docelowe punkty końcowe. Wyniki można filtrować dalej, wybierając filtry Protokół lub Host i odpowiednią opcję.

   

Obecnie witryna Azure Portal nie obsługuje bezpośredniej modyfikacji aprowizowanych punktów końcowych. Opis punktu końcowego można jednak zmodyfikować przy użyciu programu Azure PowerShell, postępując zgodnie z tym przykładem. Zasoby punktu końcowego, które wymagają aktualizacji w witrynie Azure Portal, należy usunąć i ponownie utworzyć.

1. Get-AzStorageMoverEndpoint Użyj polecenia cmdlet , aby pobrać listę zasobów punktu końcowego. Opcjonalnie możesz podać wartość parametru -Name , aby pobrać określony zasób. Wywołanie cmdlet bez opcjonalnego parametru zwraca listę wszystkich aprowizowanych punktów końcowych skojarzonych z zasobem usługi przenoszenia danych.

   Poniższy przykład pobiera określony zasób projektu, określając wartość nazwy demoTarget .

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

   Przykładowa odpowiedź zawiera właściwości określonego projektu, w tym pustą Description właściwość.

   
   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. Brakujący opis można dodać do punktu końcowego zwróconego w poprzednim przykładzie, dołączając operator potoku Update-AzStorageMoverAzStorageSmbFileShareEndpoint i polecenie cmdlet. Poniższy przykład dostarcza brakującą wartość punktu końcowego udziału plików SMB za pomocą parametru -Description.

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

   Odpowiedź zawiera teraz zaktualizowaną Description wartość właściwości.

   
   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. Aby usunąć punkt końcowy przy użyciu portalu Azure, przejdź do strony zasobów usługi Storage Mover. Wybierz pozycję Punkty końcowe magazynu w okienku nawigacji, aby uzyskać dostęp do swoich punktów końcowych, jak pokazano na poniższym obrazku.

   

2. Domyślny widok Źródłowych punktów końcowych zawiera nazwy wszystkich aprowizowanych punktów końcowych źródłowych oraz podsumowanie skojarzonych z nimi danych. Możesz wybrać filtr Docelowe punkty końcowe , aby wyświetlić odpowiednie docelowe punkty końcowe.

   Znajdź nazwę punktu końcowego, który chcesz usunąć, i zaznacz odpowiednie pole wyboru. Po sprawdzeniu, czy wybrano odpowiedni punkt końcowy, wybierz pozycję Usuń , jak pokazano na poniższej ilustracji.

   

   Nowy punkt końcowy zostanie usunięty i nie będzie już wyświetlany na liście punktów końcowych, jak pokazano na poniższym przykładowym obrazie.

   

Użyj elementu , Remove-AzStorageMoverEndpoint aby trwale usunąć zasób punktu końcowego. Podaj nazwę punktu końcowego z parametrem -Name, a nazwy zasobu grupy zasobów oraz zasobu magazynowego mover z parametrami -ResourceGroupName i -StorageMoverName, odpowiednio.

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