Das Büro-Werkzeug ist ein Modul mit Tests und einer Prüfung durch den Analyzer. Diese Lektion bringt es an die Orte, an denen es arbeiten soll: auf einen fernen Rechner, in eine Pipeline, in eine Automatisierung. Danach sammeln Sie die Fallen, über die in diesem Kurs schon gestolpert wurde, an einer Stelle, jede mit der Ausgabe, die sie zeigt.
Ausgeführt wurde in PowerShell 7.6.9 auf Windows 11. Was ein fernes Ziel, eine Pipeline oder ein Azure-Konto braucht, ist nicht ausgeführt, gegen Learn gelesen; jeder dieser Abschnitte hat einen Teil, der ohne den Dienst läuft.
Remoting über SSH
PowerShell kann Befehle auf einem anderen Rechner ausführen. Learn („PowerShell remoting over SSH“): Das Remoting nutzt normalerweise WinRM; SSH ist inzwischen auf Linux und Windows
verfügbar und erlaubt ein Remoting zwischen allen Plattformen. Es braucht PowerShell 6 oder höher und SSH auf beiden Rechnern (Client ssh und Server sshd); der Server bekommt in
seiner Konfiguration einen Eintrag, der PowerShell als SSH-Subsystem startet (die Seite zeigt die Zeile je Plattform). Die drei Befehle New-PSSession, Enter-PSSession und
Invoke-Command haben einen Parametersatz mit -HostName, -UserName und -KeyFilePath. Nicht ausgeführt:
Enter-PSSession -HostName '<host>' -UserName '<user>' -KeyFilePath '<private-key-file>'
Invoke-Command -HostName '<host>' -UserName '<user>' -ScriptBlock { Get-Date }
Enter-PSSession öffnet eine interaktive Sitzung, Invoke-Command führt einen Skriptblock aus und liefert das Ergebnis. Zwei Dinge hält Learn fest: Bei der Anmeldung per Passwort fragt PowerShell
interaktiv, und besser ist ein Schlüssel (-KeyFilePath); und SSH-Remoting unterstützt derzeit keine Endpunkt-Konfiguration und kein Just Enough Administration (JEA). Wer JEA braucht,
braucht WinRM. Wie bei jeder Anmeldung gilt PS.4.2: Der Schlüssel liegt nie im Skript und nie im Repository.
Was zurückkommt, läuft ohne SSH nach. Ein Ergebnis aus der Ferne ist kein lebendes Objekt, sondern eine Abschrift, die wieder zu einem Objekt aufgebaut wurde. Das lässt sich ohne fernen Rechner mit einem Auftrag zeigen, der in einem eigenen Prozess läuft und seine Ergebnisse auf demselben Weg zurückgibt:
$job = Start-Job { Get-Item $env:TEMP }
$item = Receive-Job $job -Wait -AutoRemoveJob
$item.GetType().FullName
$item.PSObject.TypeNames[0]
($item | Get-Member -MemberType Method | Measure-Object).Count
$local = Get-Item $env:TEMP
$local.GetType().FullName
($local | Get-Member -MemberType Method | Measure-Object).Count
System.Management.Automation.PSObject
Deserialized.System.IO.DirectoryInfo
2
System.IO.DirectoryInfo
20
Der Auftrag hat dasselbe DirectoryInfo gelesen, aber zurück kam ein PSObject mit dem Typnamen Deserialized.System.IO.DirectoryInfo: Die Eigenschaften sind da, die meisten
Methoden nicht (2 gegenüber 20). Daraus folgt eine Regel für ferne Skripte: Holen Sie aus der Ferne Daten (Eigenschaften, Zahlen, Text), und lassen Sie jede Handlung auf der Gegenseite im
Skriptblock geschehen, statt das Ergebnis zurückzuholen und dort aufzurufen. Der Skriptblock bekommt Werte nicht von selbst: Nutzen Sie -ArgumentList (und param(...) im Block) oder
$using:variable. Ein Rechner, der wie ein ferner Rechner behandelt werden soll, braucht außerdem seinen eigenen -WhatIf: Ein Skript, das fernen Befehlen etwas ändern lässt, steht hinter
ShouldProcess, und die Änderung läuft erst im Block, nachdem ShouldProcess ja gesagt hat.