PowerShell-Modul: Tutorial

Anmerkung

Diese Funktion ist nur in der Nerdio ManagerPremium-Edition verfügbar.

Dieses Dokument erläutert, wie Sie das PowerShell-Modul für Nerdio Manager herunterladen, installieren und verwenden. Das PowerShell-Modul für Nerdio Manager ist ein Wrapper für die Nerdio Manager REST-API.

Anmerkung

Das PowerShell-Modul für Nerdio Manager befindet sich in der Public Preview. Bitte senden Sie Ihr Feedback hier ein.

Installieren Sie das PowerShell-Modul aus der PowerShell Gallery

Die folgenden Schritte müssen ausgeführt werden, um das PowerShell-Modul aus der Microsoft PowerShell Gallery zu installieren.

So installieren Sie das Modul:
  1. Öffnen Sie die PowerShell ISE als Administrator.

  2. Führen Sie den folgenden Befehl aus:

    Install-Module -Name NerdioManagerPowerShell

  3. Wählen Sie bei der entsprechenden Aufforderung Ja, alle.

Installieren Sie das PowerShell-Modul von GitHub

Die folgenden Schritte müssen ausgeführt werden, um das PowerShell-Modul zu installieren.

So installieren Sie das Modul:
  1. Öffnen Sie einen Browser und navigieren Sie zu https://github.com/Get-Nerdio/NerdioManagerPowerShell.

  2. Wählen Sie Code > Download Zip.

  3. Optional, abhängig von der Betriebssystemsicherheit, geben Sie die Zip-Datei frei.

    • Klicken Sie mit der rechten Maustaste auf die Zip-Datei und wählen Sie Eigenschaften.

    • Wählen Sie unten im Bereich Allgemein die Option freigeben.

    • Wählen Sie OK.

  4. Entpacken Sie die Datei.

    Anmerkung

    Wenn Sie die Windows-Funktion zum Extrahieren komprimierter Dateien verwenden, entfernen Sie NerdioManagerPowerShell-Main vom Ende des Pfads. Wenn dies nicht geschieht, befindet sich ein verschachteltes NerdioManagerPowerShell-Main im Pfad.

  5. Öffnen Sie die PowerShell ISE und navigieren Sie zu dem Ordner aus dem vorherigen Schritt. (zum Beispiel CD C:\\Users\\ssa\\Downloads\\NerdioManagerPowerShell-Main)

    Anmerkung

    Wenn Sie dieses PowerShell-Modul in der Entwicklung verwenden, möchten Sie es möglicherweise installieren, damit es standardmäßig zugänglich ist. Anweisungen finden Sie in diesem Microsoft-Artikel.

  6. Führen Sie in PowerShell den folgenden Befehl aus, um das PowerShell-Modul zu importieren:

    Import-Module NerdioManagerPowerShell

  7. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob die Installation ordnungsgemäß abgeschlossen wurde:

    Get-Command -Module NerdioManagerPowerShell

Anmerkung

Nach erfolgreicher Installation gibt der vorherige Befehl eine Ausgabe zurück, die wie folgt aussieht:

image1460.png

Verwenden Sie das PowerShell-Modul

Um das PowerShell-Modul zu verwenden, müssen Sie mit dem folgenden Befehl eine Verbindung zu Ihrer Nerdio Manager-Bereitstellung herstellen:

Connect-NME -ClientId $NmeClientId -ClientSecret $NmeClientSecret -TenantId $NmeTenantId -ApiScope $NmeScope -NmeUri $NmeUri

Sie müssen die erforderlichen Parameter aus Ihrer Nerdio Manager-Bereitstellung abrufen.

So rufen Sie die erforderlichen Parameter ab:
  1. Navigieren Sie in Nerdio Manager zu System > Einstellungen > Integration.

  2. Wählen Sie im Bereich REST-API neben Anmeldedaten die Option anzeigen.

  3. Es öffnet sich ein Fenster, das ClientId, ClientSecret, TenantId und Scope anzeigt.

Anmerkung

  • Das ClientSecret ist ausgeblendet. Wenn es unbekannt ist, kann es neu generiert werden, um einen neuen Wert anzuzeigen und zu erstellen. Speichern Sie den Wert an einem sicheren Ort, wie z. B. Azure Key Vault, um später darauf zugreifen zu können. Es ist nicht möglich, den Wert abzurufen, nachdem Sie die Seite verlassen haben.

  • Der NmeUri-Parameter ist der URI der Nerdio Manager-Bereitstellung (zum Beispiel https://nmw-app-i55ow6qye6hc6.azurewebsites.net).

Verwandte Themen

PowerShell-Modul: Erweiterter Leitfaden

War dieser Beitrag hilfreich?

1 von 1 fanden dies hilfreich
Haben Sie Fragen? Anfrage einreichen

Kommentare (0 Kommentare)

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.