| external help file | keywords | locale | Module Name | ms.date | schema | title |
|---|---|---|---|---|---|---|
ConsoleGuiToolsModule.dll-Help.xml |
powershell,cmdlet |
en-us |
Microsoft.PowerShell.ConsoleGuiTools |
07/20/2023 |
2.0.0 |
Show-ObjectTree |
Sends output to an interactive tree in the same console window.
Show-ObjectTree [-InputObject <PSObject>] [-Title <string>] [-Filter <string>] [-MinUi] [-UseNetDriver] [<CommonParameters>]The Show-ObjectTree cmdlet sends the output from a command to a tree view window where the output is displayed in an interactive tree.
You can use the following features of the tree to examine your data:
- Quick Filter. Use the Filter box at the top of the window to search the text in the tree. You can search for literals or multiple words. You can use the
-Filtercommand to pre-populate the Filter box. The filter uses regular expressions.
For instructions for using these features, type Get-Help Show-ObjectTree -Full and see How to Use the Tree View Window Features in the Notes section.
PS C:\> Get-Process | Show-ObjectTreeThis command gets the processes running on the local computer and sends them to a tree view window.
PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | shotThis command saves its output in a variable and sends it to Show-ObjectTree.
The command uses the Get-ChildItem cmdlet to get the files in the Windows PowerShell installation directory and its subdirectories. The path to the installation directory is saved in the $pshome automatic variable.
The command uses the assignment operator (=) to save the output in the $A variable and the pipeline operator (|) to send the output to Show-ObjectTree.
The parentheses in the command establish the order of operations. As a result, the output from the Get-ChildItem command is saved in the $A variable before it is sent to Show-ObjectTree.
Pre-populates the Filter edit box, allowing filtering to be specified on the command line.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSpecifies that the cmdlet accepts input for Show-ObjectTree.
When you use the InputObject parameter to send a collection of objects to Show-ObjectTree, Show-ObjectTree treats the collection as one collection object, and it displays one row that represents the collection.
To display the each object in the collection, use a pipeline operator (|) to send objects to Show-ObjectTree.
Type: PSObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseSpecifies the text that appears in the title bar of the Show-ObjectTree window.
By default, the title bar displays the command that invokes Show-ObjectTree.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseIf specified no window frame, filter box, or status bar will be displayed in the Show-ObjectTree window.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
You can send any object to this cmdlet.
Show-ObjectTree does not output any objects.
-
The command output that you send to Show-ObjectTree should not be formatted, such as by using the Format-Table or Format-Wide cmdlets. To select properties, use the Select-Object cmdlet.
-
Deserialized output from remote commands might not be formatted correctly in the tree view window.