Von Discovery ausgeführte PowerShell-Befehle
Diese Seite enthält die PowerShell-Cmdlets und ihre Parameter, die Discovery zur Steuerung und Automatisierung der Verwaltung von Windows-Servern und -Anwendungen ausführt. Enthalten sind die Probe-Parameter und MID Server-Skripts, die die Befehle enthalten.
| Cmdlet/Parameter | Beschreibung |
|---|---|
Add-Content
|
Hängt Inhalte an ein angegebenes Element oder eine angegebene Datei an. Sie können den Inhalt angeben, indem Sie ihn in den Befehl eingeben oder indem Sie ein Objekt angeben, das den Inhalt enthält.
|
Add-Member
|
Ermöglicht das Hinzufügen von Eigenschaften und Methoden zu einer Instanz eines Windows PowerShell-Objekts. Beispielsweise können Sie ein NoteProperty-Mitglied hinzufügen, das eine Beschreibung des Objekts enthält, oder ein ScriptMethod-Mitglied, das ein Skript zum Ändern des Objekts ausführt.
|
Add-Type
|
Fügt in Ihrer Windows PowerShell-Sitzung eine Microsoft .NET Framework-Klasse hinzu. Sie können dann das Cmdlet „New-Object“ verwenden, um Objekte zu instanziieren und diese Objekte wie jedes andere .NET Framework-Objekt zu verwenden. Wenn Sie Ihrem Windows PowerShell-Profil den Befehl Add-Type hinzufügen, ist die Klasse in allen Windows PowerShell-Sitzungen verfügbar.
|
Compare-Object
|
Vergleicht zwei Objektsätze. Ein Objektsatz ist der Referenzsatz, der andere Satz ist der Differenzsatz. Das Ergebnis des Vergleichs gibt an, ob ein Eigenschaftswert nur im Objekt aus dem Referenzsatz oder, wenn der Parameter IncludeEqual angegeben ist, in beiden Objekten vorkommt.
|
ConvertTo-SecureString
|
Konvertiert verschlüsselte Standardzeichenfolgen in sichere Zeichenfolgen. Es kann auch Nur-Text in sichere Zeichenfolgen konvertieren. Es wird mit ConvertFrom-SecureString und Read-Host verwendet. Die von dem Cmdlet erstellte sichere Zeichenfolge kann mit Cmdlets oder Funktionen verwendet werden, die einen Parameter vom Typ SecureString erfordern.
|
| ConvertTo-Json | Konvertiert ein beliebiges Objekt in eine Zeichenfolge im JSON-Format (JavaScript Object Notation). Eigenschaften werden in Feldnamen sowie Feldwerte in Eigenschaftswerte konvertiert, und Methoden werden entfernt.
|
Copy-Item
|
Kopiert ein Element von einem Speicherort an einen anderen Speicherort im selben Namespace. Beispielsweise kann eine Datei in einen Ordner kopiert werden, jedoch nicht auf ein Zertifikatlaufwerk.
|
| ForEach-Objekt: Prozess | Führt einen Vorgang für jedes Element in einer Sammlung von Eingabeobjekten durch. Die Eingabeobjekte können an das Cmdlet weitergeleitet oder mithilfe des InputObject-Parameters angegeben werden.
|
| Format-List | Formatiert die Ausgabe eines Befehls als Liste von Eigenschaften, in denen jede Eigenschaft in einer separaten Zeile angezeigt wird. Mit Format-List können Sie alle oder ausgewählte Eigenschaften eines Objekts als Liste formatieren und anzeigen.
|
Get-ChildItem
|
Ruft die Elemente an einem oder mehreren angegebenen Speicherorten ab. Wenn das Element ein Container ist, werden die Elemente innerhalb des Containers, sogenannte untergeordnete Elemente, abgerufen. Mit dem Parameter Recurse können Sie Elemente in allen untergeordneten Containern abrufen.
|
Get-Content
|
Ruft den Inhalt von Elementen am durch den Pfad angegebenen Speicherort ab, zum Beispiel den Text in einer Datei. Dabei wird der Inhalt Zeile für Zeile gelesen, und es wird eine Sammlung von Objekten zurückgegeben, von denen jedes eine Inhaltszeile repräsentiert.
|
| Get-Date: Uformat | Ruft ein DateTime-Objekt ab, das das aktuelle Datum oder ein von Ihnen angegebenes Datum darstellt. Datum und Uhrzeit können in verschiedenen Windows- und UNIX-Formaten formatiert werden. Mit Get-Date können Sie eine Datums- oder Uhrzeitzeichenfolge generieren und diese Zeichenfolge dann an andere Cmdlets oder Programme senden.
|
| Get-Item | Ruft das Element am angegebenen Speicherort ab. Der Inhalt des Elements wird nicht am Speicherort abgerufen, es sei denn, Sie verwenden ein Platzhalterzeichen (*), um den gesamten Inhalt des Elements anzufordern.
|
Get-ItemProperty
|
Ruft die Eigenschaften der angegebenen Elemente ab. Beispielsweise können Sie mit diesem Cmdlet den Wert der Eigenschaft LastAccessTime eines Dateiobjekts abrufen. Sie können dieses Cmdlet auch zum Anzeigen von Registrierungseinträgen und deren Werten verwenden.
|
| Get-Member: MemberType | Ruft die Mitglieder, Eigenschaften und Methoden von Objekten ab. Verwenden Sie zum Festlegen des Objekts den Parameter InputObject, oder leiten Sie ein Objekt an Get-Member weiter. Verwenden Sie zum Abrufen von Informationen über statische Mitglieder (die Mitglieder der Klasse, nicht der Instanz) den Parameter Static. Wenn Sie nur bestimmte Typen von Mitgliedern abrufen möchten, zum Beispiel NoteProperties, verwenden Sie den Parameter MemberType.
|
Get-Process
|
Ruft die Prozesse auf einem lokalen Computer oder Remotecomputer ab. Ohne Parameter ruft dieses Cmdlet alle Prozesse auf dem lokalen Computer ab. Sie können einen bestimmten Prozess auch anhand des Prozessnamens oder der Prozess-ID (PID) angeben oder ein Prozessobjekt über die Pipeline an dieses Cmdlet übergeben.
|
Get-PSDrive
|
Ruft die Laufwerke in der aktuellen Sitzung ab. Sie können ein bestimmtes Laufwerk oder alle Laufwerke in der Sitzung abrufen.
|
| Get-PSSession | Ruft die von Benutzern verwalteten Windows PowerShell-Sitzungen (PSSessions) auf lokalen und Remotecomputern ab
|
| Get-Variable: Name | Ruft die Windows PowerShell-Variablen in der aktuellen Konsole ab. Sie können nur die Werte der Variablen abrufen, indem Sie den Parameter ValueOnly angeben, und Sie können die zurückgegebenen Variablen nach Namen filtern.
|
Get-WmiObject
|
Ruft Instanzen von WMI-Klassen (Windows Management Instrumentation) oder Informationen über die verfügbaren WMI-Klassen ab. Um einen Remotecomputer anzugeben, verwenden Sie den Parameter ComputerName. Wenn der Parameter List angegeben ist, ruft das Cmdlet Informationen über die in einem angegebenen Namespace verfügbaren WMI-Klassen ab. Wenn der Parameter Query angegeben ist, führt das Cmdlet eine WQL-Anweisung (WMI Query Language) aus.
|
| Get-WSManInstance: ResourceURI | Ruft eine Instanz einer Verwaltungsressource ab, die durch einen Ressourcen-URI (Uniform Resource Identifier) angegeben ist. Die abgerufenen Informationen können ein komplexer XML-Informationssatz (ein Objekt) oder ein einfacher Wert sein.
|
| Gruppenobjekt: NoElement | Zeigt Objekte in Gruppen basierend auf dem Wert einer angegebenen Eigenschaft an. Group-Object gibt eine Tabelle mit einer Zeile für jeden Eigenschaftswert und einer Spalte zurück, in der die Anzahl der Elemente mit diesem Wert angezeigt wird.
|
Import-Module
|
Fügt der aktuellen Sitzung mindestens ein Modul hinzu. Die von Ihnen importierten Module müssen auf dem lokalen Computer oder einem Remotecomputer installiert sein.
|
Invoke-Command
|
Führt Befehle auf einem lokalen Computer oder Remotecomputer aus und gibt die gesamte Ausgabe der Befehle zurück, einschließlich Fehler. Mit einem einzigen Befehl Invoke-Command können Sie Befehle auf mehreren Computern ausführen.
|
| Invoke-Expression | Wertet oder führt eine angegebene Zeichenfolge als Befehl aus und gibt die Ergebnisse des Ausdrucks oder Befehls zurück. Ohne Invoke-Expression würde eine an die Befehlszeile übermittelte Zeichenfolge unverändert zurückgegeben (als Echo-Zeichenfolge wiederholt).
|
Invoke-WmiMethod
|
Ruft die Methoden von WMI-Objekten (Windows Management Instrumentation) auf
|
| Messobjekt: Summe | Berechnet die Eigenschaftswerte bestimmter Objekttypen. Measure-Object führt abhängig von den Parametern im Befehl drei Arten von Messungen durch.
|
New-Item
|
Erstellt ein neues Element und legt dessen Wert fest. Welche Elementtypen erstellt werden können, hängt vom Speicherort des Elements ab. Beispielsweise erstellt New-Item im Dateisystem Dateien und Ordner. In der Registrierung erstellt New-Item hingegen Registrierungsschlüssel und -einträge.
|
New-Object
|
Erstellt eine Instanz eines Microsoft .NET Framework- oder COM-Objekts
|
New-PSDrive
|
Erstellt temporäre und persistente Laufwerke, die einem Speicherort in einem Datenspeicher wie einem Netzlaufwerk, einem Verzeichnis auf einem lokalen Computer oder einem Registrierungsschlüssel zugeordnet sind, sowie persistente, in Windows zugeordnete Netzlaufwerke, die einem Speicherort im Dateisystem auf einem Remotecomputer zugeordnet sind.
|
New-Variable
|
Erstellt eine neue Variable in Windows PowerShell. Sie können der Variablen während der Erstellung einen Wert zuweisen oder den Wert nach der Erstellung zuweisen oder ändern.
|
New-PSSession
|
Erstellt eine Windows PowerShell-Sitzung (PSSession) auf einem lokalen Computer oder Remotecomputer. Beim Erstellen einer PSSession stellt Windows PowerShell eine dauerhafte Verbindung zu einem Remotecomputer her.
|
| New-PSSessionOption | Erstellt ein Objekt, das erweiterte Optionen für eine von Benutzern verwaltete Sitzung enthält. Sie können das Objekt als Wert des Parameters SessionOption von Cmdlets verwenden, die eine PSSession erstellen, zum Beispiel New-PSSession, Enter-PSSession und Invoke-Command.
|
New-Timespan
|
Erstellt ein Zeitspannenobjekt, das ein Intervall darstellt. Sie können diesen Befehl für die Addition oder Subtraktion von Zeit bei einem DateTime-Objekt verwenden.
|
| Ausgehende Datei: Dateipfad | Sendet die Ausgabe an eine Datei. Sie können diesen Operator anstelle von > verwenden, wenn Sie die zugehörigen Parameter verwenden müssen.
|
| Out-Null | Sendet die Ausgabe an NULL, wodurch sie effektiv gelöscht wird
|
| Out-String | Konvertiert die von Windows PowerShell verwalteten Objekte in ein Array von Zeichenfolgen. Standardmäßig akkumuliert Out-String die Zeichenfolgen und gibt sie als einzelne Zeichenfolge zurück. Sie können den Parameter stream jedoch auch dazu verwenden, Out-String anzuweisen, jeweils eine Zeichenfolge zurückzugeben. Mit diesem Cmdlet können Sie die Zeichenfolgenausgabe durchsuchen und sie wie in herkömmlichen Shells bearbeiten, wenn die Objektbearbeitung weniger praktisch ist.
|
| Receive-Job | Ruft die Ergebnisse von Windows PowerShell-Hintergrundaufträgen ab, zum Beispiel solchen, die mit dem Cmdlet Start-Job oder dem Parameter AsJob eines beliebigen Cmdlet gestartet wurden. Sie können die Ergebnisse aller Aufträge abrufen oder Aufträge anhand von Name, ID, Instanz-ID, Computername, Speicherort bzw. Sitzung oder durch Übermittlung eines Auftragsobjekts identifizieren.
|
Remove-Item
|
Löscht mindestens ein Element. Da es von vielen Anbietern unterstützt wird, kann es viele verschiedene Elementtypen löschen, einschließlich Dateien, Ordner, Registrierungsschlüssel, Variablen, Aliase und Funktionen.
|
| Remove-Job | Löscht Windows PowerShell-Hintergrundaufträge. Sie können Aufträge starten, indem Sie Start-Job oder den Parameter AsJob eines beliebigen Cmdlet verwenden. Sie können dieses Cmdlet zum Löschen aller Aufträge oder zum Löschen von Aufträgen basierend auf Name, ID, Instanz-ID, Befehl oder Status bzw. durch Übergabe eines Auftragsobjekts an Remove-Job verwenden. Ohne Parameter oder Parameterwerte hat Remove-Job keine Auswirkungen.
|
| Remove-PSDrive: Name | Löscht temporäre Windows PowerShell-Laufwerke, die mit dem Cmdlet New-PSDrive erstellt wurden
|
| Remove-PSSession: Sitzung | Schließt Windows PowerShell-Sitzungen (PSSessions) in der aktuellen Sitzung. Das Cmdlet beendet alle Befehle, die in PSSessions ausgeführt werden, beendet die PSSession und gibt die Ressourcen frei, die von der PSSession verwendet wurden. Wenn die PSSession mit einem Remotecomputer verbunden ist, schließt dieses Cmdlet auch die Verbindung zwischen dem lokalen Computer und dem Remotecomputer.
|
Remove-Variable
|
Löscht eine Variable und ihren Wert aus dem Bereich, in dem sie definiert ist, zum Beispiel in der aktuellen Sitzung. Sie können dieses Cmdlet nicht verwenden, um Variablen zu löschen, die als Konstanten festgelegt oder systemspezifisch sind.
|
Rename-Item
|
Ändert den Namen eines angegebenen Elements. Dieses Cmdlet wirkt sich nicht auf den Inhalt des Elements aus, das umbenannt wird. Sie können Rename-Item nicht zum Verschieben eines Elements verwenden, beispielsweise durch Angabe eines Pfads zusammen mit dem neuen Namen. Um ein Element zu verschieben und umzubenennen, verwenden Sie das Cmdlet Move-Item.
|
Select-Object
|
Dient zur Auswahl bestimmter Eigenschaften eines Objekts oder Objektsatzes. Mit dem Cmdlet lassen sich außerdem spezifische Objekte, eine bestimmte Anzahl von Objekten oder Objekte an einer bestimmten Position in einem Array auswählen. Alias ist „Select“.
|
Select-String
|
Sucht nach Text und Textmustern in Eingabezeichenfolgen und Dateien. Sie können es wie Grep in UNIX und Findstr in Windows verwenden. Sie können Select-String oder den entsprechenden Alias sls eingeben.
|
Select-XML
|
Ermöglicht die Verwendung von XPath-Abfragen zur Suche nach Text in XML-Zeichenfolgen und -Dokumenten. Geben Sie eine XPath-Abfrage ein, und verwenden Sie den Parameter Content, Path oder Xml, um die zu durchsuchende XML-Datei anzugeben.
|
Set-Content
|
Schreibt oder ersetzt den Inhalt im angegebenen Element, zum Beispiel einer Datei. Sie können den Inhalt in den Befehl eingeben oder Inhalt über die Pipeline an Set-Content senden.
|
| Standort festlegen: Pfad | Legt den Arbeitsort auf einen angegebenen Speicherort fest: ein Verzeichnis, Unterverzeichnis, Registrierungsspeicherort oder beliebiger Anbieterpfad.
|
| Set-StrictMode: Version | Konfiguriert den strikten Modus für den aktuellen Umfang und alle untergeordneten Bereiche und aktiviert bzw. deaktiviert ihn. Im strikten Modus generiert Windows PowerShell einen Abschlussfehler, wenn der Inhalt eines Ausdrucks, Skripts oder Skriptblocks gegen grundlegende bewährte Codierungsregeln verstößt.
|
Set-Variable
|
Weist einer angegebenen Variablen einen Wert zu oder ändert den aktuellen Wert. Wenn die Variable nicht vorhanden ist, wird sie durch das Cmdlet erstellt.
|
| Sortierobjekt: Eigenschaft | Sortiert Objekte in aufsteigender oder absteigender Reihenfolge basierend auf den Werten der Eigenschaften des Objekts. Sie können eine einzelne Eigenschaft oder mehrere Eigenschaften (für eine Sortierung mit mehreren Schlüsseln) angeben und eine Sortierung auswählen, bei der die Groß-/Kleinschreibung berücksichtigt bzw. nicht berücksichtigt wird. Sie können Sort-Object auch anweisen, nur die Objekte mit einem eindeutigen Wert für eine bestimmte Eigenschaft anzuzeigen.
|
Split-Path
|
Gibt nur den angegebenen Teil eines Pfads zurück, zum Beispiel den übergeordneten Ordner, einen Unterordner oder einen Dateinamen. Das Cmdlet kann auch Elemente abrufen, auf die der geteilte Pfad verweist, und feststellen, ob der Pfad relativ oder absolut ist.
|
Start-Sleep
|
Hält die Aktivität für den angegebenen Zeitraum in einem Skript oder einer Sitzung an. Sie können es verwenden, während Sie auf den Abschluss eines Vorgangs warten oder eine Pause einlegen, bevor Sie den Vorgang wiederholen.
|
| Stop-Job | Beendet gerade laufende Hintergrundaufträge der Windows PowerShell. Sie können dieses Cmdlet zum Anhalten aller Aufträge oder zum Anhalten bestimmter Aufträge basierend auf Name, ID, Instanz-ID oder Status bzw. durch Übergabe eines Auftragsobjekts an Stop-Job verwenden.
|
Test-Path
|
Bestimmt, ob alle Elemente des Pfads vorhanden sind. Gibt $True zurück, wenn alle Elemente vorhanden sind, und $False, wenn nicht alle da sind. Kann auch bestimmen, ob die Pfadsyntax gültig ist und ob der Pfad zu einem Container, einem Terminal oder einem Blattelement führt
|
Test-WSMan
|
Sendet eine Identifizierungsanforderung, die bestimmt, ob der WinRM-Service auf einem lokalen Computer oder Remotecomputer ausgeführt wird. Wenn der Service auf dem getesteten Computer ausgeführt wird, zeigt das Cmdlet das Identitätsschema von WS-Management, die Protokollversion, den Produktanbieter und die Produktversion des getesteten Service an.
|
| Where-Object | Wählt Objekte mit bestimmten Eigenschaftswerten aus der Sammlung von Objekten aus, die an sie übergeben werden. Beispielsweise sind mit dem Cmdlet Where-Object folgende Auswahlvorgänge möglich: Dateien, die nach einem bestimmten Datum erstellt wurden, Ereignisse mit einer bestimmten ID oder Computer mit einer bestimmten Version von Windows.
|
Write-Error
|
Deklariert einen nicht endenden Fehler. Standardmäßig werden Fehler im Fehlerstream zusammen mit der Ausgabe an das anzuzeigende Hostprogramm gesendet.
|
| Write-Host: NoNewLine | Schreibt benutzerdefinierte Ausgaben an einen Host. Sie können die Farbe des Texts mithilfe des Parameters ForegroundColor und die Hintergrundfarbe mithilfe des Parameters BackgroundColor angeben. Mit dem Parameter Separator können Sie eine Zeichenfolge angeben, die zum Trennen von angezeigten Objekten verwendet wird. Das jeweilige Ergebnis hängt von dem Programm ab, das Windows PowerShell hostet.
|
| Write-Output | Sendet die angegebenen Objekte an den nächsten Befehl in der Pipeline. Wenn dies der letzte Befehl in der Pipeline ist, werden die Objekte in der Konsole angezeigt.
|
| Ausführlich schreiben: Nachricht | Schreibt Text in den ausführlichen Nachrichtenstrom in Windows PowerShell. Normalerweise wird der ausführliche Nachrichtenstrom verwendet, um Informationen über die Befehlsverarbeitung bereitzustellen, die für das Debugging eines Befehls verwendet wird.
|