Ihr Einstiegsleitfaden zu genehmigten PowerShell-Verben – techsyncer

Wenn es um das PowerShell-Skripting geht, machen konsistente Namenskonventionen das Erstellen robuster Lösungen viel einfacher. Die gute Nachricht ist, dass es von PowerShell genehmigte Verben gibt, die Sie beim Schreiben von Skripten und Befehlen verwenden können.

In diesem Tutorial lernen Sie durch eine Reihe von Beispielen, welche genehmigten Verben Sie in PowerShell verwenden können.

Steigen Sie gleich ein und verbessern Sie Ihr PowerShell-Skripting!

Voraussetzungen

Dieses Tutorial umfasst praktische Demonstrationen. Wenn Sie mitmachen möchten, stellen Sie sicher, dass Sie ein System mit PowerShell 5.1 oder neuer ausführen. Dieses Tutorial verwendet Windows 11 mit PowerShell 7.

Abrufen einer Liste von von PowerShell genehmigten Verben

In PowerShell sind Cmdlets kleine, einzelfunktionale Befehle, die bestimmte Aktionen in der PowerShell-Umgebung ausführen.

Jedes Cmdlet in PowerShell hat einen eindeutigen Namen, der einem Verb-Nomen-Paar-Format folgt, bei dem:

Der Verbteil des Namens beschreibt die Aktion, die das Cmdlet ausführt. Einige häufig verwendete Verben in PowerShell sind wie folgt:

Verb	Function
`Get`	Retrieves information.
`Set`	Changes or updates settings.
`New`	Creates something new.
`Remove`	Deletes or removes something.

Der Nounteil des Namens identifiziert die Entität oder das Objekt, auf dem die Aktion ausgeführt wird, das Ziel, auf das die Aktion angewendet wird. Das Nomen beschreibt in der Regel die Kategorie oder Art des Objekts, mit dem das Cmdlet interagiert, wie Befehl, Prozess, Dienst oder Datei.

Um alle genehmigten Verben für Ihr Skript anzuzeigen:

Führen Sie den folgenden Get-Verb-Befehl aus, um eine vollständige Liste der von PowerShell genehmigten Verben zu erhalten.

Get-Verb

Die Ausgabe unten zeigt nur einige Verben, die Sie für Ihr Skript verwenden können.

Retrieving a complete list of approved verbs

Jetzt führen Sie denselben Befehl wie unten aus, aber diesmal listen Sie alle genehmigten Verben auf, die mit re beginnen, über eine Wildcard-Suche. Auf diese Weise wird die Liste der Verben auf diejenigen beschränkt, die mit zurücksetzen, ändern der Größe, wiederholen usw. verbunden sind.

Get-Verb re*

Wie unten gezeigt, kann das Einschränken der Verbenliste hilfreich sein, wenn Sie eine bestimmte Aktion im Kopf haben und ein Verb finden möchten, das dieser Aktion nahe kommt.

Narrowing down the list of approved verbs

Erstellen neuer Ressourcen über das `New`-Verb

Sie haben gerade eine Liste der genehmigten Verben in PowerShell abgerufen, aber wie verwenden Sie diese Verben in Ihrem Skript oder beim Ausführen von Befehlen? Sie fügen dem Nomen, das den Typ der Ressource repräsentiert (z. B. Benutzer, Datei, Dienst), das New-Verb vor.

Aber in diesem Beispiel werden Sie eine neue Ressource erstellen, genauer gesagt einen neuen Benutzer, wie folgt:

Führen Sie den folgenden New-LocalUser-Befehl aus, um einen neuen Benutzer namens John Smith mit einem Passwort (Password123) zu erstellen und das Konto so einzustellen, dass es nie abläuft (-AccountNeverExpires).

New-LocalUser -Name "John Smith" -AccountNeverExpires -Password (ConvertTo-SecureString -AsPlainText "Password123" -Force

Creating a new resource (user account) via the New verb

Abrufen von Ressourceninformationen über das `Get`-Verb

Abgesehen von der Erstellung neuer Ressourcen ermöglicht PowerShell auch ein Verb, das es Ihnen ermöglicht, Informationen über vorhandene Ressourcen abzurufen. In PowerShell wird das Get-Verb häufig verwendet, um Informationen zu einer bestimmten Ressource abzurufen, wie z. B. dem Betriebssystem, Diensten, Dateien und anderen Objekten.

Um Ressourceninformationen über das Get-Verb abzurufen:

Führen Sie den folgenden Befehl Get-LocalUser aus, um Informationen über einen bestimmten lokalen Benutzer (John Smith) zu erhalten.

Get-LocalUser -Name "John Smith"

Unten zeigt die Ausgabe, dass das Benutzerkonto John Smith Aktiviert (aktiv) ist.

Retrieving resource information via the `Get` verb

Ändern von vorhandenen Ressourcen über das `Set`-Verb

Stellen Sie sich vor, Sie haben festgestellt, dass etwas nicht stimmt, nachdem Sie Informationen zu einer Ihrer Ressourcen gesehen haben. Wie können Sie eine vorhandene Ressource ändern? Keine Sorge! Ein von PowerShell genehmigtes Verb, das Set-Verb, ermöglicht es Ihnen, Änderungen an vorhandenen Ressourcen vorzunehmen.

Anstatt Ressourcen neu zu erstellen, ermöglicht Ihnen das Set-Verb, Anpassungen vorzunehmen, indem Sie deren Eigenschaften oder Konfigurationen ändern.

Um vorhandene Ressourcen über das Set-Verb zu ändern:

Führen Sie die unten stehenden Befehle aus, um den Wert von `$myVariable` auf `Hallo` zu setzen und den Wert von `$myVariable` auf `Hallo, Welt!` zu ändern. Diese Befehle geben keine Ausgabe zurück, aber Sie werden die Änderungen im nächsten Schritt überprüfen.

# Definiere eine Variable
$myVariable = "Hello"

# Ändere den Wert einer vorhandenen Variable
Set-Variable -Name myVariable -Value "Hello, World!"

Führen Sie nun den Befehl Get-Variable unten aus, um Informationen über Ihre Ressource (`$myVariable`) abzurufen.

Get-Variable -Name myVariable

Wie unten gezeigt, zeigt die Ausgabe den Namen und den Wert der Variable an.

Auslösen von Aktionen oder Aufrufen von Befehlen über das `Invoke`-Verb

Statt Befehle manuell auszuführen, wie Sie es in den vorherigen Beispielen getan haben, warum automatisieren Sie sie nicht in einem PowerShell-Skript? Wie? Das Invoke-Verb ermöglicht es Ihnen, Aktionen zu initiieren oder Befehle programmgesteuert aufzurufen.

Mit einem PowerShell-Skript und dem Invoke-Verb können Sie mehrere PowerShell-Befehle auf einmal ausführen, ohne sie alle in der Konsole einzugeben.

Um zu sehen, wie das Auslösen von Aktionen über das Invoke-Verb funktioniert:

1. Führen Sie den folgenden Invoke-Expression-Befehl aus, um den Get-Date-Befehl aufzurufen, der Ihnen das aktuelle Datum und die aktuelle Uhrzeit zurückgibt.

Invoke-Expression -Command "Get-Date"

Die Ausgabe unten zeigt eine erfolgreiche Ausführung des Get-Date-Befehls über das Invoke-Verb.

Triggering a command via the `Invoke` verb

2. Erstellen Sie als Nächstes eine PowerShell-Skriptdatei (d. h. InvokeVerbDemo.ps1) mit Ihrem bevorzugten Code-Editor und füllen Sie den folgenden Code ein.

Dieser Code zeigt (Write-Host) eine Begrüßungsnachricht an und ruft das Get-Service-Cmdlet auf, um alle Dienste in Ihrem System aufzulisten.

# Zeigen Sie eine herzliche Begrüßungsnachricht an
Write-Host "Welcome to the Invoke Example!"

# Rufen Sie das Get-Service-Cmdlet auf
Invoke-Command -ScriptBlock { Get-Service }

3. Führen Sie nun die folgenden Befehle aus, um Ihr PowerShell-Skript (InvokeVerbDemo.ps1) aufzurufen (Invoke-Expression). Ersetzen Sie den Wert der Variablen $scriptPath durch den Pfad Ihrer Skriptdatei.

$scriptPath = "C:\PowerShellScripts\InvokeVerbDemo.ps1"
Invoke-Expression -Command $scriptPath

Die Ausgabe unten zeigt eine Begrüßungsnachricht und eine Liste aller Dienste in Ihrem System, was die erfolgreiche Ausführung Ihres Skripts bestätigt.

4. Anstatt nur Befehle zu verwenden, schreiben Sie eine wiederverwendbare Funktion (z.B. Invoke-MyTask), die Sie jederzeit aufrufen können, wie unten gezeigt. Funktionen verbessern im Wesentlichen die Wartbarkeit und Wiederverwendbarkeit Ihrer PowerShell-Skripte.

In diesem Beispiel umschließt die Funktion Invoke-MyTask Befehle, die beim Aufrufen Folgendes ausführen:

Zeigt (Write-Host) den String MyTask wird ausgeführt... auf der Konsole an.
Ruft die Liste aller Prozesse (Get-Process) ab und wählt nur (Select-Object) die Name und CPU Eigenschaften für jeden Prozess aus.

# Definieren Sie eine benutzerdefinierte Funktion unter Verwendung des Verbs Invoke
function Invoke-MyTask {
    # Ihr benutzerdefinierter Task kommt hierhin
    Write-Host "Executing MyTask..."
    Get-Process | Select-Object Name, CPU
}

5. Schließlich führen Sie den folgenden Befehl aus, um Ihre Funktion aufzurufen (Invoke-MyTask).

Invoke-Expression -Command Invoke-MyTask

Sie werden eine Liste aller auf Ihrem System ausgeführten Prozesse mit ihren Namen und CPU-Auslastung sehen, wie unten gezeigt.

Validieren von Ressourcen über das `Test` Verb

Die Genauigkeit der Eingabewerte und Bedingungen ist von höchster Bedeutung beim Erstellen robuster und fehlerresistenter PowerShell-Skripte. Ein leistungsstarkes Werkzeug, das Ihnen dafür zur Verfügung steht, ist das Test Verb.

Indem Sie das Test Verb verwenden, können Sie schnell überprüfen, ob eine gegebene Bedingung einen wahren oder falschen Wert hat, was es Ihnen ermöglicht, je nach Ergebnis verschiedene Aktionen auszuführen. In diesem Beispiel werden Sie über das Test Verb überprüfen, ob eine Datei existiert.

Führen Sie den untenstehenden Code aus, um zu testen (Test-Path), ob eine Datei existiert (C:\MeinOrdner\beispiel.txt) an dem angegebenen $filePath und geben Sie eine Nachricht je nach Ergebnis aus.

# Definieren Sie einen Dateipfad.
$filePath = "C:\MyFolder\example.txt"

# Testen Sie, ob die Datei existiert, und geben Sie je nach Ergebnis eine Nachricht aus.
if (Test-Path $filePath) {
    Write-Host "The file exists at $filePath."
}
else {
    Write-Host "The file does not exist at $filePath."
}

Validating a resource via the `Test` verb

Schlussfolgerung

Sie haben nun ein grundlegendes Verständnis für von PowerShell genehmigte Verben und wie Sie sie effektiv in Ihren Skripten und Befehlen verwenden können. Durch die Nutzung dieser Verben können Sie nun robuste, effiziente und konsistente PowerShell-Lösungen für verschiedene Aufgaben und Szenarien erstellen.

Dieses Tutorial ist nur der Anfang Ihrer Reise, um ein versierter PowerShell-Benutzer zu werden. Warum lernen Sie nicht auch andere genehmigte Verben, wie z.B. Datenmanipulationsverben (d.h. Export, Import, Sort) und Lebenszyklusverben (z.B. Start, Stop)? Bringen Sie Ihre PowerShell-Fähigkeiten noch heute auf die nächste Stufe!

Voraussetzungen

Abrufen einer Liste von von PowerShell genehmigten Verben

Erstellen neuer Ressourcen über das New-Verb

Abrufen von Ressourceninformationen über das Get-Verb

Ändern von vorhandenen Ressourcen über das Set-Verb

Auslösen von Aktionen oder Aufrufen von Befehlen über das Invoke-Verb