Een Azure Data Box Gateway-apparaat beheren via Windows Power shell

Met Azure Data Box Gateway oplossing kunt u gegevens via het netwerk naar Azure verzenden. In dit artikel worden enkele van de configuratie-en beheer taken voor uw Data Box Gateway-apparaat beschreven. U kunt de Azure Portal, de lokale webgebruikersinterface of de Windows Power shell-interface gebruiken om uw apparaat te beheren.

Dit artikel is gericht op de taken die u gebruikt om de Power shell-interface te gebruiken.

Dit artikel bevat de volgende procedures:

  • Verbinding maken met de PowerShell-interface
  • Een ondersteunings pakket maken
  • Certificaat uploaden
  • Opstarten in niet-DHCP-omgeving
  • Apparaatgegevens weer geven

Verbinding maken met de PowerShell-interface

Afhankelijk van het besturings systeem van de client zijn de procedures om een externe verbinding met het apparaat te maken verschillend.

Extern verbinding maken vanaf een Windows-client

Voordat u begint, moet u ervoor zorgen dat Windows Power shell 5,0 of hoger wordt uitgevoerd op de Windows-client.

Volg deze stappen om vanaf een Windows-client extern verbinding te maken.

  1. Een Windows Power shell-sessie uitvoeren als beheerder.

  2. Zorg ervoor dat de Windows Remote Management-service wordt uitgevoerd op de client. Typ in de opdrachtprompt:

    winrm quickconfig

  3. Wijs een variabele toe aan het IP-adres van het apparaat.

    $ip = "<device_ip>"

    Vervang door <device_ip> het IP-adres van uw apparaat.

  4. Typ de volgende opdracht om het IP-adres van uw apparaat toe te voegen aan de lijst met vertrouwde hosts van de client:

    Set-Item WSMan:\localhost\Client\TrustedHosts $ip -Concatenate -Force

  5. Start een Windows Power shell-sessie op het apparaat:

    Enter-PSSession -ComputerName $ip -Credential $ip\EdgeUser -ConfigurationName Minishell

  6. Geef het wacht woord op wanneer u hierom wordt gevraagd. Gebruik hetzelfde wacht woord dat wordt gebruikt om u aan te melden bij de lokale webgebruikersinterface. Het standaard wacht woord voor de lokale web-UI is Wachtwoord1. Wanneer u verbinding met het apparaat met behulp van externe Power shell hebt gemaakt, ziet u de volgende voorbeeld uitvoer:

    Windows PowerShell
    Copyright (C) Microsoft Corporation. All rights reserved.
    
    PS C:\WINDOWS\system32> winrm quickconfig
    WinRM service is already running on this machine.
    PS C:\WINDOWS\system32> $ip = "10.100.10.10"
    PS C:\WINDOWS\system32> Set-Item WSMan:\localhost\Client\TrustedHosts $ip -Concatenate -Force
    PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $ip -Credential $ip\EdgeUser -ConfigurationName Minishell
    
    WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing. Changes made through this interface without involving Microsoft Support could result in an unsupported configuration.
    [10.100.10.10]: PS>
    

Extern verbinding maken vanaf een Linux-client

Op de Linux-client die u gebruikt om verbinding te maken:

Ga voor meer informatie naar externe toegang tot Power shell via SSH.

Volg deze stappen om vanaf een NFS-client extern verbinding te maken.

  1. Als u Power shell-sessie wilt openen, typt u:

    pwsh

  2. Als u verbinding wilt maken via de externe client, typt u:

    Enter-PSSession -ComputerName $ip -Authentication Negotiate -ConfigurationName Minishell -Credential ~\EdgeUser

    Wanneer u hierom wordt gevraagd, geeft u het wacht woord op waarmee u zich aanmeldt bij uw apparaat.

Notitie

Deze procedure werkt niet in macOS.

Een ondersteunings pakket maken

Als u problemen ondervindt met het apparaat, kunt u een ondersteunings pakket maken op basis van de systeem Logboeken. Microsoft Ondersteuning gebruikt dit pakket om de problemen op te lossen. Volg deze stappen voor het maken van een ondersteunings pakket:

  1. Verbinding maken met de Power shell-interface van uw apparaat.

  2. Gebruik de Get-HcsNodeSupportPackage opdracht om een ondersteunings pakket te maken. Het gebruik van de cmdlet is als volgt:

    Get-HcsNodeSupportPackage [-Path] <string> [-Zip] [-ZipFileName <string>] [-Include {None | RegistryKeys | EtwLogs
            | PeriodicEtwLogs | LogFiles | DumpLog | Platform | FullDumps | MiniDumps | ClusterManagementLog | ClusterLog |
            UpdateLogs | CbsLogs | StorageCmdlets | ClusterCmdlets | ConfigurationCmdlets | KernelDump | RollbackLogs |
            Symbols | NetworkCmdlets | NetworkCmds | Fltmc | ClusterStorageLogs | UTElement | UTFlag | SmbWmiProvider |
            TimeCmds | LocalUILogs | ClusterHealthLogs | BcdeditCommand | BitLockerCommand | DirStats | ComputeRolesLogs |
            ComputeCmdlets | DeviceGuard | Manifests | MeasuredBootLogs | Stats | PeriodicStatLogs | MigrationLogs |
            RollbackSupportPackage | ArchivedLogs | Default}] [-MinimumTimestamp <datetime>] [-MaximumTimestamp <datetime>]
            [-IncludeArchived] [-IncludePeriodicStats] [-Credential <pscredential>]  [<CommonParameters>]
    

    De cmdlet verzamelt logboeken van uw apparaat en kopieert deze logboeken naar een opgegeven netwerk of lokale share.

    De volgende para meters worden gebruikt:

    • -Path -Geef het netwerk of het lokale pad op waarnaar u het ondersteunings pakket wilt kopiëren. lang
    • -Credential -Geef de referenties op voor toegang tot het beveiligde pad.
    • -Zip -Geef op of u een zip-bestand wilt genereren.
    • -Include -Geef op of u de onderdelen wilt opnemen die moeten worden opgenomen in het ondersteunings pakket. Als niet wordt opgegeven, Default wordt ervan uitgegaan.
    • -IncludeArchived -Geef op of u gearchiveerde logboeken wilt toevoegen aan het ondersteunings pakket.
    • -IncludePeriodicStats -Geef op of u periodieke Statie logboeken wilt gebruiken in het ondersteunings pakket.

Certificaat uploaden

Een correct SSL-certificaat zorgt ervoor dat u versleutelde gegevens naar de juiste server verzendt. Het certificaat kan behalve versleuteld ook worden geverifieerd. U kunt uw eigen vertrouwde SSL-certificaat uploaden via de Power shell-interface van het apparaat.

  1. Verbinding maken met de Power shell-interface.

  2. Gebruik de Set-HcsCertificate cmdlet om het certificaat te uploaden. Geef desgevraagd de volgende para meters op:

    • CertificateFilePath -Het pad naar de share met het certificaat bestand in PFX -indeling.

    • CertificatePassword -Een wacht woord dat wordt gebruikt om het certificaat te beveiligen.

    • Credentials -Gebruikers naam voor toegang tot de share met het certificaat. Geef het wachtwoord voor de netwerkshare op wanneer u hierom wordt gevraagd.

      In het volgende voor beeld ziet u het gebruik van deze cmdlet:

      Set-HcsCertificate -Scope LocalWebUI -CertificateFilePath "\\myfileshare\certificates\mycert.pfx" -CertificatePassword "mypassword" -Credential "Username"
      

Opstarten in niet-DHCP-omgeving

Als u opstart in een niet-DHCP-omgeving, voert u de volgende stappen uit om de virtuele machine te implementeren voor uw Data Box Gateway.

  1. Maak verbinding met de Windows Power shell-interface van het apparaat.

  2. Gebruik de Get-HcsIpAddress cmdlet om de netwerk interfaces weer te geven die zijn ingeschakeld op het virtuele apparaat. Als voor uw apparaat één netwerkinterface is ingeschakeld, wordt Ethernet als standaardnaam aan deze interface toegewezen.

    In het volgende voor beeld ziet u het gebruik van deze cmdlet:

    [10.100.10.10]: PS>Get-HcsIpAddress
    
    OperationalStatus : Up
    Name              : Ethernet
    UseDhcp           : True
    IpAddress         : 10.100.10.10
    Gateway           : 10.100.10.1
    
  3. Gebruik de cmdlet Set-HcsIpAddress om het netwerk te configureren. Zie het volgende voorbeeld:

    Set-HcsIpAddress –Name Ethernet –IpAddress 10.161.22.90 –Netmask 255.255.255.0 –Gateway 10.161.22.1
    

Apparaatgegevens weer geven

  1. Verbinding maken met de Power shell-interface.

  2. Gebruik de Get-HcsApplianceInfo om de informatie voor uw apparaat op te halen.

    In het volgende voor beeld ziet u het gebruik van deze cmdlet:

    [10.100.10.10]: PS>Get-HcsApplianceInfo
    
    Id                            : b2044bdb-56fd-4561-a90b-407b2a67bdfc
    FriendlyName                  : DBE-NBSVFQR94S6
    Name                          : DBE-NBSVFQR94S6
    SerialNumber                  : HCS-NBSVFQR94S6
    DeviceId                      : 40d7288d-cd28-481d-a1ea-87ba9e71ca6b
    Model                         : Virtual
    FriendlySoftwareVersion       : Data Box Gateway 1902
    HcsVersion                    : 1.4.771.324
    IsClustered                   : False
    IsVirtual                     : True
    LocalCapacityInMb             : 1964992
    SystemState                   : Initialized
    SystemStatus                  : Normal
    Type                          : DataBoxGateway
    CloudReadRateBytesPerSec      : 0
    CloudWriteRateBytesPerSec     : 0
    IsInitialPasswordSet          : True
    FriendlySoftwareVersionNumber : 1902
    UploadPolicy                  : All
    DataDiskResiliencySettingName : Simple
    ApplianceTypeFriendlyName     : Data Box Gateway
    IsRegistered                  : False
    

    Hier volgt een tabel met een overzicht van een aantal belang rijke informatie over apparaten:

    Parameter Beschrijving
    FriendlyName De beschrijvende naam van het apparaat zoals geconfigureerd via de lokale web-UI tijdens de implementatie van het apparaat. De standaard beschrijvende naam is het serie nummer van het apparaat.
    SerialNumber Het serie nummer van het apparaat is een uniek nummer dat is toegewezen aan de Factory.
    Model Het model voor uw apparaat. Het model is virtueel voor Data Box Gateway.
    FriendlySoftwareVersion De beschrijvende teken reeks die overeenkomt met de versie van de apparaatsoftware. Voor een systeem met Preview wordt de beschrijvende software versie Data Box Edge 1902.
    HcsVersion De versie van de HCS-software die op uw apparaat wordt uitgevoerd. De HCS-software versie die overeenkomt met Data Box Edge 1902 is bijvoorbeeld 1.4.771.324.
    LocalCapacityInMb De totale lokale capaciteit van het apparaat in megabits.
    IsRegistered Deze waarde geeft aan of uw apparaat is geactiveerd met de service.

Volgende stappen