Verwalten von Azure Storage Mover-Endpunkten

1. Navigieren Sie im Azure-Portal zur Ressourcenseite des Storage Mover . Wählen Sie im Navigationsbereich Speicherendpunkte aus, um auf Ihre Speicherendpunkte zuzugreifen.

   

   Auf der Seite Speicherendpunkte zeigt die Standardansicht für Speicherendpunkte die Namen aller bereitgestellten Quellendpunkte und eine Zusammenfassung der zugehörigen Eigenschaften an. Sie können Zielendpunkte auswählen, um die entsprechenden Zielendpunkte anzuzeigen. Sie können die Ergebnisse auch weiter filtern, indem Sie entweder die Protokollversion oder den Hostfilter auswählen und die entsprechende Option auswählen.

   

2. Wählen Sie "Endpunkt erstellen" aus, um das Menü " Endpunkttyp " zu erweitern. Wählen Sie "Quellendpunkt erstellen" aus, um den Bereich " Quellendpunkt erstellen" zu öffnen, wie in der folgenden Abbildung dargestellt.

   

3. Geben Sie im Bereich "Quellendpunkt erstellen" Werte für die erforderlichen Hostnamen oder IP- und Freigabenamenwerte an. Der Hostname oder der IP-Adresswert muss entweder eine IPv4-Adresse oder vollqualifizierte Domäne oder hostname sein.

   Von Bedeutung

   Je nach DNS-Konfiguration müssen Sie möglicherweise ihren vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) anstelle Ihres Hostnamens verwenden.

   Sie können auch einen optionalen Beschreibungswert von bis zu 1024 Zeichen länge hinzufügen. Wählen Sie als Nächstes die Protokollversion aus, um das Protokollauswahlmenü zu erweitern und die entsprechende Option für Ihr Quellziel auszuwählen.

   Speicherverschiebungs-Agents verwenden geheime Schlüssel, die in Key Vault gespeichert sind, um eine Verbindung mit SMB-Endpunkten herzustellen. Wenn Sie einen SMB-Quellendpunkt erstellen, müssen Sie sowohl den Namen des Schlüsseltresors angeben, der die Geheimnisse enthält, als auch die Namen der Geheimnisse selbst.

   Wählen Sie zuerst den Schlüsseltresor aus, um das Menü zu erweitern, und wählen Sie den Namen des Schlüsseltresors aus, der Ihre geheimen Schlüssel enthält. Sie können bei Bedarf einen Wert angeben, mit dem die Liste der Key Vaults gefiltert werden soll.

   

   Nachdem Sie den entsprechenden Schlüsseltresor ausgewählt haben, können Sie Werte für den erforderlichen "Geheimen Schlüssel" für "Benutzername " und "Geheimer Schlüssel für Kennwortfelder auswählen " angeben. Diese Werte können durch Bereitstellen des URI für die geheimen Schlüssel oder durch Auswählen der geheimen Schlüssel aus einer Liste bereitgestellt werden. Wählen Sie die Schaltfläche "Geheim auswählen" aus, um das Menü zu aktivieren und die Benutzernamen- und Kennwortwerte auszuwählen. Alternativ können Sie die Option Geheimnis aus URI eingeben aktivieren und den entsprechenden URI für Benutzername und Passwort-Geheimnis bereitstellen.

   Die Werte für Host und Freigabename werden verkettet, um den vollständigen Migrationsquellenpfad zu bilden. Der Pfadwert wird im Feld "Vollständiger Quellpfad " angezeigt. Kopieren Sie den angegebenen Pfad, und überprüfen Sie, ob Sie darauf zugreifen können, bevor Sie Ihre Änderungen committen. Wählen Sie abschließend nach der Bestätigung, dass alle Werte korrekt sind und dass Sie auf den Quellpfad zugreifen können, " Erstellen" aus, um Ihren neuen Endpunkt hinzuzufügen.

   

   Ihr neuer Endpunkt wird bereitgestellt und wird nun in der Liste der Quellendpunkte angezeigt, wie in der folgenden Beispielabbildung dargestellt.

   

Die Cmdlets New-AzStorageMoverSmbEndpoint und New-AzStorageMoverNfsEndpoint verwendet, um einen neuen Endpunkt in einer zuvor bereitgestellten Storage Mover-Ressource zu erstellen.

Wenn Sie das Az.StorageMover Modul nicht installiert haben:

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

Weitere Hilfe zum Installieren von Azure PowerShell finden Sie im Artikel " Installieren von Azure PowerShell ".

1. Es ist immer ratsam, Variablen zu erstellen und zu verwenden, um langwierige oder potenziell komplexe Zeichenfolgen zu speichern.

   Von Bedeutung

   Je nach DNS-Konfiguration müssen Sie möglicherweise ihren vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) anstelle Ihres Hostnamens verwenden.

   Kopieren Sie den Beispielcodeblock, und geben Sie Werte für die erforderlichen Parameter an. Der Parameter -Description ist optional und wird im Abschnitt „Eigenschaften eines Endpunkts anzeigen und bearbeiten“ hinzugefügt.

   
   ## 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. Stellen Sie mithilfe des Cmdlets Connect-AzAccount eine Verbindung mit Ihrem Azure-Konto her. Geben Sie die ID für Ihr Abonnement an, indem Sie einen Wert für den -Subscription Parameter angeben, wie im Beispiel gezeigt.

   
   Connect-AzAccount -Subscription $subscriptionID
   
   

3. Nachdem Sie die Verbindung erfolgreich hergestellt haben, können Sie neue Quellendpunktressourcen erstellen. Je nach Anforderung können Sie das New-AzStorageMoverSmbEndpoint Cmdlet verwenden, um einen SMB-Endpunkt zu erstellen, wie im folgenden Beispiel gezeigt.

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

   Alternativ können Sie einen neuen NFS-Quellendpunkt erstellen, indem Sie das New-AzStorageMoverNfsEndpoint Cmdlet wie gezeigt verwenden.

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

   Die folgende Beispielantwort enthält die ProvisioningState Eigenschaft, die angibt, dass der Endpunkt erfolgreich erstellt wurde.

   
   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. Navigieren Sie im Azure-Portal zur Ressourcenseite des Storage Mover . Wählen Sie im Navigationsbereich Speicherendpunkte aus, um auf Ihre Speicherendpunkte zuzugreifen.

   

   Auf der Seite Speicherendpunkte zeigt die Standardansicht für Speicherendpunkte die Namen aller bereitgestellten Quellendpunkte und eine Zusammenfassung der zugehörigen Eigenschaften an. Wählen Sie Zielendpunkte aus, um die vorhandenen Zielendpunkte anzuzeigen. Sie können die Ergebnisse weiter filtern, indem Sie den Speicherkontofilter und die entsprechende Option auswählen.

   

2. Wählen Sie "Endpunkt erstellen" aus, um das Menü " Endpunkttyp " zu erweitern. Wählen Sie " Zielendpunkt erstellen" aus, um den Bereich " Zielendpunkt erstellen " zu öffnen, wie in der folgenden Abbildung dargestellt.

   

3. Wählen Sie im Bereich " Zielendpunkt erstellen " Ihr Abonnement- und Zielspeicherkonto aus den Listen "Abonnement" bzw. " Speicherkonto " aus. Wählen Sie als Nächstes die entsprechende Zieltypoption aus, die Ihrem Zielendpunkt entspricht.

   Das aktuelle Azure Storage Mover-Release unterstützt nur Migrationsvorgänge mit vollständiger Genauigkeit für bestimmte Kombinationen von Quell-/Zielpaaren. Nutzen Sie immer die neueste Agent-Version, um von diesen unterstützten Quellen und Zielen zu profitieren:

   Quellprotokoll	Ziel	Kommentare
   AWS S3	Azure-Blobcontainer	AWS (Amazon Web Services) S3-Buckets mit Glacier- oder Glacier Deep Archive-Speicherklassen können nicht migriert werden.
   SMB 2.x- und 3.x-Mount	Azure-Dateifreigabe (SMB)	SMB 1.x-Quellen und NFS Azure-Dateifreigaben werden derzeit nicht unterstützt.
   SMB 2.x- und 3.x-Mount	Azure-Blobcontainer	Container mit aktiviertem Feature „Flacher Namespace (FNS)“ und „Hierarchischer Namespacedienst (HNS)“ werden unterstützt, und der REST-API-Satz für Azure Data Lake Storage Gen2 (ADLS Gen2) wird für die Migration verwendet.
   NFS 3- und 4-Einbindung	Azure-Blobcontainer	Container mit aktiviertem Feature „Flacher Namespace (FNS)“ und „Hierarchischer Namespacedienst (HNS)“ werden unterstützt, und der REST-API-Satz für Azure Data Lake Storage Gen2 (ADLS Gen2) wird für die Migration verwendet.
   NFS 3- und 4-Einbindung	Azure-Dateifreigabe (NFS 4.1)	NFS-Azure-Dateifreigaben werden mit NFS v3/4-Quelle unterstützt.

   Wählen Sie je nach ausgewähltem Zieltyp entweder Ihren Blobcontainer oder Ihre Dateifreigabe aus der entsprechenden Dropdownliste aus. Schließlich können Sie einen optionalen Beschreibungswert für Ihr Ziel von bis zu 1024 Zeichen länge hinzufügen und " Erstellen" auswählen, um Ihren Endpunkt bereitzustellen.

   

Ihr neuer Endpunkt wird bereitgestellt und wird nun in Ihrer Liste der Endpunkte angezeigt, wie in der folgenden Beispielabbildung dargestellt.

1. Um eine neue SMB-Dateifreigabe zu erstellen, verwenden Sie das New-AzStorageMoverAzStorageSmbFileShareEndpoint Cmdlet wie im folgenden Beispiel gezeigt.

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

Verwenden Sie das New-AzStorageMoverAzStorageContainerEndpoint PowerShell-Cmdlet, um einen neuen NFS-Blobcontainer zu erstellen. Im folgenden Beispiel finden Sie Anleitungen zur Bereitstellung.

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

Die folgende Beispielantwort enthält die ProvisioningState Eigenschaft, die angibt, dass der Endpunkt erfolgreich erstellt wurde.

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. Um einen Endpunkt mithilfe des Azure-Portals zu erstellen, navigieren Sie zur Storage Mover-Ressourcenseite. Wählen Sie im Navigationsbereich Speicherendpunkte aus, wie im Beispielbild gezeigt, um auf Ihre Speicherendpunkte zuzugreifen.

   

2. Auf der Seite Speicherendpunkte zeigt die Standardansicht für Speicherendpunkte die Namen aller bereitgestellten Quellendpunkte und eine Zusammenfassung der zugehörigen Eigenschaften an. Um den bereitgestellten Zielendpunkt anzuzeigen, wählen Sie "Zielendpunkte" aus. Sie können die Ergebnisse weiter filtern, indem Sie die Protokoll - oder Hostfilter und die entsprechende Option auswählen.

   

Derzeit unterstützt das Azure-Portal die direkte Änderung der bereitgestellten Endpunkte nicht. Die Beschreibung eines Endpunkts kann jedoch mithilfe von Azure PowerShell mithilfe dieses Beispiels geändert werden. Endpunktressourcen, die eine Aktualisierung im Azure-Portal erfordern, sollten gelöscht und neu erstellt werden.

1. Verwenden Sie das Get-AzStorageMoverEndpoint Cmdlet, um eine Liste der Endpunktressourcen abzurufen. Optional können Sie einen -Name Parameterwert angeben, um eine bestimmte Ressource abzurufen. Wenn Sie das Cmdlet ohne den optionalen Parameter aufrufen, wird eine Liste aller bereitgestellten Endpunkte zurückgegeben, die Ihrer Speicherverschiebungsressource zugeordnet sind.

   Im folgenden Beispiel wird eine bestimmte Projektressource abgerufen, indem der Wert des demoTarget-Namens angegeben wird.

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

   Die Beispielantwort enthält die Eigenschaften des angegebenen Projekts, einschließlich der leeren Description Eigenschaft.

   
   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. Sie können dem im vorherigen Beispiel zurückgegebenen Endpunkt die fehlende Beschreibung hinzufügen, indem Sie einen Pipelineoperator und das Update-AzStorageMoverAzStorageSmbFileShareEndpoint Cmdlet einschließen. Im folgenden Beispiel wird der fehlende SMB-Dateifreigabeendpunktwert mit dem -Description Parameter bereitgestellt.

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

   Die Antwort enthält nun den aktualisierten Description Eigenschaftswert.

   
   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. Um einen Endpunkt mithilfe des Azure-Portals zu löschen, navigieren Sie zur Ressourcenseite des Speicherverschiebungselements . Wählen Sie im Navigationsbereich die Option Speicherendpunkte aus, um auf Ihre Endpunkte zuzugreifen, wie in der folgenden Abbildung zu sehen.

   

2. Die Standardmäßige Ansicht "Quellendpunkte" zeigt die Namen aller bereitgestellten Quellendpunkte und eine Zusammenfassung der zugehörigen Daten an. Sie können den Zielendpunktfilter auswählen, um die entsprechenden Zielendpunkte anzuzeigen.

   Suchen Sie den Namen des Endpunkts, den Sie löschen möchten, und aktivieren Sie das entsprechende Kontrollkästchen. Nachdem Sie überprüft haben, ob Sie den entsprechenden Endpunkt ausgewählt haben, wählen Sie "Löschen" aus, wie in der folgenden Abbildung dargestellt.

   

   Ihr neuer Endpunkt wird gelöscht und wird nicht mehr in Ihrer Liste der Endpunkte angezeigt, wie in der folgenden Beispielbild dargestellt.

   

Verwenden Sie die Remove-AzStorageMoverEndpoint Ressource zum endgültigen Löschen einer Endpunktressource. Geben Sie den Namen des Endpunkts mit dem -Name Parameter und die Namen von Ressourcengruppe und Speicherverschiebungsressource mit den Parametern -ResourceGroupName und -StorageMoverName an.

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