Windows PowerShell command on Get-command Out-String
MyWebUniversity

Windows PowerShell command on Get-command Out-String

NAME

Out-String

SYNOPSIS

Sends objects to the host as a series of strings.

SYNTAX

Out-String [-InputObject ] [-Stream] [-Width ] []

DESCRIPTION

The Out-String cmdlet converts the objects that Windows PowerShell manages into an array of strings. By default,

Out-String accumulates the strings and returns them as a single string, but you can use the stream parameter to

direct Out-String to return one string at a time. This cmdlet lets you search and manipulate string output as you

would in traditional shells when object manipulation is less convenient.

PARAMETERS

-InputObject

Specifies the objects to be written to a string. Enter a variable that contains the objects, or type a command or expression that gets the objects. Required? false Position? named Default value None Accept pipeline input? True (ByValue) Accept wildcard characters? false

-Stream []

Indicates that the cmdlet sends the strings for each object separately. By default, the strings for each object are accumulated and sent as a single string.

To use the Stream parameter, type `-Stream` or its alias, `ost`.

Required? false Position? named Default value False Accept pipeline input? False Accept wildcard characters? false

-Width

Specifies the number of characters in each line of output. Any additional characters are truncated, not wrapped. If you omit this parameter, the width is determined by the characteristics of the host program. The default value for the Windows PowerShell console is 80 (characters). Required? false Position? named Default value None Accept pipeline input? False Accept wildcard characters? false This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.Management.Automation.PSObject

You can pipe objects to Out-String .

OUTPUTS

System.String

Out-String returns the string that it creates from the input object.

NOTES

The cmdlets that contain the Out verb that do not format objects; they just render them and send them to the

specified display destination. If you send an unformatted object to an Out * cmdlet, the cmdlet sends it to a

formatting cmdlet before rendering it. The Out cmdlets do not have parameters that take names or file paths. To send data to an Out cmdlet, use a pipeline operator (|) to send the output of a Windows PowerShell command

to the cmdlet. You can also store data in a variable and use the InputObject* parameter to pass the data to

the cmdlet.

*

Example 1: Output text to the console as a string

PS C:\>Get-Content C:\test1\testfile2.txt | Out-String

This command sends the content of the Testfile2.txt file to the console as a single string. It uses the

Get-Content cmdlet to get the content of the file. The pipeline operator (|) sends the content to Out-String ,

which sends the content to the console as a string.

Example 2: Get the current culture and convert the data to strings.

The first command uses the Get-Culture cmdlet to get the regional settings. The pipeline operator (|) sends the

result to the Select-Object cmdlet, which selects all properties (*) of the culture object that **Get-Culture**

returned. The command then stores the results in the $C variable.

PS C:\>$C = Get-Culture | Select-Object *

The second command uses the **Out-String** cmdlet to convert the **CultureInfo** object to a series of strings

(one string for each property). It uses the *InputObject* parameter to pass the $C variable to **Out-String**. The

*Width* parameter is set to 100 characters per line to prevent truncation.

PS C:\>Out-String -InputObject $C -Width 100

These commands get the regional settings for the current user and convert the data to strings.

Example 3: Working with objects

PS C:\>Get-Alias | Out-String -Stream | Select-String "Get-Command"

This example demonstrates the difference between working with objects and working with strings. The command

displays aliases that include the phrase Get-Command. It uses the Get-Alias cmdlet to get a set of AliasInfo

objects (one for each alias in the current session).

The pipeline operator (|) sends the output of the Get-Alias cmdlet to the Out-String cmdlet, which converts the

objects to a series of strings. It uses the Stream parameter of Out-String to send each string individually,

instead of concatenating them into a single string. Another pipeline operator sends the strings to the

Select-String cmdlet, which selects the strings that include Get-Command anywhere in the string.

If you omit the Stream parameter, the command displays all of the aliases, because Select-String finds Get-Command

in the single string that Out-String returns, and the formatter displays the string as a table.

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=821842

Out-File

Out-GridView

Out-Printer



Contact us      |      About us      |      Term of use      |       Copyright © 2000-2019 OurUNIX.com ™