diff --git a/reference/5.1/Microsoft.PowerShell.Core/Out-Default.md b/reference/5.1/Microsoft.PowerShell.Core/Out-Default.md index a06c58887e26..5e43fece28e4 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Out-Default.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Out-Default.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 02/07/2023 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-default?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Default @@ -20,24 +20,9 @@ Out-Default [-Transcript] [-InputObject ] [] ## DESCRIPTION -PowerShell automatically adds `Out-Default` to the end of every pipeline. `Out-Default` decides how -to format and output the object stream. If the object stream is a stream of strings, `Out-Default` -pipes these directly to `Out-Host` which calls the appropriate APIs provided by the host. If the -object stream does not contain strings, `Out-Default` inspects the object to determine what to do. -First it looks at the object type and determines whether there is a registered _view_ for this -object type. - -PowerShell defines an XML schema and a mechanism (the `Update-FormatData` cmdlet) where anyone can -register views for an object type. You can specify **wide**, **list**, **table**, or **custom** -views for any object type. The views specify which properties to display and how they should be -displayed. If a view is registered, it defines which formatter to use. So if the registered view is -a **table** view, `Out-Default` streams the objects to `Format-Table | Out-Host`. `Format-Table` -transforms the objects into a stream of Formatting records (driven by the data in the view -definition) and `Out-Host` transforms the formatting records into calls on the Host interface. - -This cmdlet isn't intended to be used by the end user. Other cmdlets are recommended for controlling -output like [Out-Host](Out-Host.md) or using `Format-*` cmdlets and the [Format.ps1xml](About/about_format.ps1xml.md) -file to control formatting. +PowerShell automatically adds `Out-Default` to the end of every top-level interactive pipeline. +`Out-Default` passes the objects it receives to the PowerShell format system. Then, it writes the +formatted output to the console. This cmdlet isn't intended to be used by the end user. ## EXAMPLES @@ -82,7 +67,7 @@ Accept wildcard characters: False ### -Transcript -Determines whether the output should be sent to PowerShell's transcription services. +When you use this parameter, the output is only sent to the PowerShell transcript. ```yaml Type: System.Management.Automation.SwitchParameter @@ -100,7 +85,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS diff --git a/reference/5.1/Microsoft.PowerShell.Core/Out-Host.md b/reference/5.1/Microsoft.PowerShell.Core/Out-Host.md index 43746478c472..1416a7be6404 100644 --- a/reference/5.1/Microsoft.PowerShell.Core/Out-Host.md +++ b/reference/5.1/Microsoft.PowerShell.Core/Out-Host.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 12/31/2022 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-host?view=powershell-5.1&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Host @@ -27,10 +27,9 @@ The `Out-Host` cmdlet sends output to the PowerShell host for display. The host at the command line. Because `Out-Host` is the default, you don't have to specify it unless you want to use its parameters. -`Out-Host` is automatically appended to every command that is executed. It passes the output of the -pipeline to the host executing the command. `Out-Host` ignores ANSI escape sequences. The escape -sequences are handled by the host. `Out-Host` passes ANSI escape sequences to the host without -trying to interpret or change them. +`Out-Host` passes the output of the pipeline to the host executing the command. `Out-Host` ignores +ANSI escape sequences. The escape sequences are handled by the host. `Out-Host` passes ANSI escape +sequences to the host without trying to interpret or change them. ## EXAMPLES @@ -89,14 +88,14 @@ Accept wildcard characters: False ### -Paging -Indicates that `Out-Host` displays one page of output at a time, and waits for user input before the -remaining pages are displayed. By default, all the output is displayed on a single page. The page -size is determined by the characteristics of the host. +Indicates that `Out-Host` displays one page of output at a time. The page size is determined by the +characteristics of the host. -Press the Space bar to display the next page of output or the Enter key to -view the next line of output. Press Q to quit. +After outputting the first page, the command waits for user input before the remaining pages are +displayed. Press the Spacebar to display the next page of output or the Enter +key to view the next line of output. Press Q to quit. -**Paging** is similar to the **more** command. +Using **Paging** is similar to using the **more** command. > [!NOTE] > The **Paging** parameter isn't supported by the PowerShell ISE host. @@ -117,7 +116,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -137,20 +137,22 @@ Windows PowerShell includes the following aliases for `Out-Host`: - `oh` -The **Paging** parameter isn't supported by all PowerShell hosts. For example, if you use the -**Paging** parameter in the PowerShell ISE, the following error is displayed: -`out-lineoutput : The method or operation is not implemented.` +Not all PowerShell hosts support the **Paging** parameter. For example, if you use the **Paging** +parameter in the Windows PowerShell ISE, the following error is displayed: + +> out-lineoutput : The method or operation is not implemented. The cmdlets that contain the **Out** verb, `Out-`, don't format objects. They render objects 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 don't have parameters for names or file paths. To send data to an `Out-` cmdlet, -use the pipeline to send a PowerShell command's output to the cmdlet. Or, you can store data in a -variable and use the **InputObject** parameter to pass the data to the cmdlet. +The `Out-` cmdlets don't read input from files. To send data to an `Out-` cmdlet, use the pipeline +to send data to the cmdlet. Or, you can store data in a variable and use the **InputObject** +parameter to pass the data to the cmdlet. -`Out-Host` sends data, but it doesn't produce any output objects. If you pipeline the output of -`Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects have been specified. +`Out-Host` sends data to the host only. Tt doesn't produce output objects to the pipeline. If you +pipeline the output of `Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects +have been specified. ## RELATED LINKS diff --git a/reference/7.4/Microsoft.PowerShell.Core/Out-Default.md b/reference/7.4/Microsoft.PowerShell.Core/Out-Default.md index 5d691b3bfbe8..f3408d4a7ad5 100644 --- a/reference/7.4/Microsoft.PowerShell.Core/Out-Default.md +++ b/reference/7.4/Microsoft.PowerShell.Core/Out-Default.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 02/07/2023 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-default?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Default @@ -20,24 +20,9 @@ Out-Default [-Transcript] [-InputObject ] [] ## DESCRIPTION -PowerShell automatically adds `Out-Default` to the end of every pipeline. `Out-Default` decides how -to format and output the object stream. If the object stream is a stream of strings, `Out-Default` -pipes these directly to `Out-Host` which calls the appropriate APIs provided by the host. If the -object stream does not contain strings, `Out-Default` inspects the object to determine what to do. -First it looks at the object type and determines whether there is a registered _view_ for this -object type. - -PowerShell defines an XML schema and a mechanism (the `Update-FormatData` cmdlet) where anyone can -register views for an object type. You can specify **wide**, **list**, **table**, or **custom** -views for any object type. The views specify which properties to display and how they should be -displayed. If a view is registered, it defines which formatter to use. So if the registered view is -a **table** view, `Out-Default` streams the objects to `Format-Table | Out-Host`. `Format-Table` -transforms the objects into a stream of Formatting records (driven by the data in the view -definition) and `Out-Host` transforms the formatting records into calls on the Host interface. - -This cmdlet isn't intended to be used by the end user. Other cmdlets are recommended for controlling -output like [Out-Host](Out-Host.md) or using `Format-*` cmdlets and the [Format.ps1xml](About/about_format.ps1xml.md) -file to control formatting. +PowerShell automatically adds `Out-Default` to the end of every top-level interactive pipeline. +`Out-Default` passes the objects it receives to the PowerShell format system. Then, it writes the +formatted output to the console. This cmdlet isn't intended to be used by the end user. ## EXAMPLES @@ -82,7 +67,7 @@ Accept wildcard characters: False ### -Transcript -Determines whether the output should be sent to PowerShell's transcription services. +When you use this parameter, the output is only sent to the PowerShell transcript. ```yaml Type: System.Management.Automation.SwitchParameter @@ -100,7 +85,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS diff --git a/reference/7.4/Microsoft.PowerShell.Core/Out-Host.md b/reference/7.4/Microsoft.PowerShell.Core/Out-Host.md index 3ce6bdce8735..c07c2d017470 100644 --- a/reference/7.4/Microsoft.PowerShell.Core/Out-Host.md +++ b/reference/7.4/Microsoft.PowerShell.Core/Out-Host.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 12/31/2022 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-host?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Host @@ -27,10 +27,9 @@ The `Out-Host` cmdlet sends output to the PowerShell host for display. The host at the command line. Because `Out-Host` is the default, you don't have to specify it unless you want to use its parameters. -`Out-Host` is automatically appended to every command that is executed. It passes the output of the -pipeline to the host executing the command. `Out-Host` ignores ANSI escape sequences. The escape -sequences are handled by the host. `Out-Host` passes ANSI escape sequences to the host without -trying to interpret or change them. +`Out-Host` passes the output of the pipeline to the host executing the command. `Out-Host` ignores +ANSI escape sequences. The escape sequences are handled by the host. `Out-Host` passes ANSI escape +sequences to the host without trying to interpret or change them. ## EXAMPLES @@ -89,14 +88,14 @@ Accept wildcard characters: False ### -Paging -Indicates that `Out-Host` displays one page of output at a time, and waits for user input before the -remaining pages are displayed. By default, all the output is displayed on a single page. The page -size is determined by the characteristics of the host. +Indicates that `Out-Host` displays one page of output at a time. The page size is determined by the +characteristics of the host. -Press the Space bar to display the next page of output or the Enter key to -view the next line of output. Press Q to quit. +After outputting the first page, the command waits for user input before the remaining pages are +displayed. Press the Spacebar to display the next page of output or the Enter +key to view the next line of output. Press Q to quit. -**Paging** is similar to the **more** command. +Using **Paging** is similar to using the **more** command. > [!NOTE] > The **Paging** parameter isn't supported by the PowerShell ISE host. @@ -117,7 +116,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -138,20 +138,22 @@ PowerShell includes the following aliases for `Out-Host`: - All platforms: - `oh` -The **Paging** parameter isn't supported by all PowerShell hosts. For example, if you use the -**Paging** parameter in the PowerShell ISE, the following error is displayed: -`out-lineoutput : The method or operation is not implemented.` +Not all PowerShell hosts support the **Paging** parameter. For example, if you use the **Paging** +parameter in the Windows PowerShell ISE, the following error is displayed: + +> out-lineoutput : The method or operation is not implemented. The cmdlets that contain the **Out** verb, `Out-`, don't format objects. They render objects 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 don't have parameters for names or file paths. To send data to an `Out-` cmdlet, -use the pipeline to send a PowerShell command's output to the cmdlet. Or, you can store data in a -variable and use the **InputObject** parameter to pass the data to the cmdlet. +The `Out-` cmdlets don't read input from files. To send data to an `Out-` cmdlet, use the pipeline +to send data to the cmdlet. Or, you can store data in a variable and use the **InputObject** +parameter to pass the data to the cmdlet. -`Out-Host` sends data, but it doesn't produce any output objects. If you pipeline the output of -`Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects have been specified. +`Out-Host` sends data to the host only. Tt doesn't produce output objects to the pipeline. If you +pipeline the output of `Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects +have been specified. ## RELATED LINKS diff --git a/reference/7.5/Microsoft.PowerShell.Core/Out-Default.md b/reference/7.5/Microsoft.PowerShell.Core/Out-Default.md index d1dbaa5af16a..bb89ca4b5072 100644 --- a/reference/7.5/Microsoft.PowerShell.Core/Out-Default.md +++ b/reference/7.5/Microsoft.PowerShell.Core/Out-Default.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 02/07/2023 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-default?view=powershell-7.5&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Default @@ -20,24 +20,9 @@ Out-Default [-Transcript] [-InputObject ] [] ## DESCRIPTION -PowerShell automatically adds `Out-Default` to the end of every pipeline. `Out-Default` decides how -to format and output the object stream. If the object stream is a stream of strings, `Out-Default` -pipes these directly to `Out-Host` which calls the appropriate APIs provided by the host. If the -object stream does not contain strings, `Out-Default` inspects the object to determine what to do. -First it looks at the object type and determines whether there is a registered _view_ for this -object type. - -PowerShell defines an XML schema and a mechanism (the `Update-FormatData` cmdlet) where anyone can -register views for an object type. You can specify **wide**, **list**, **table**, or **custom** -views for any object type. The views specify which properties to display and how they should be -displayed. If a view is registered, it defines which formatter to use. So if the registered view is -a **table** view, `Out-Default` streams the objects to `Format-Table | Out-Host`. `Format-Table` -transforms the objects into a stream of Formatting records (driven by the data in the view -definition) and `Out-Host` transforms the formatting records into calls on the Host interface. - -This cmdlet isn't intended to be used by the end user. Other cmdlets are recommended for controlling -output like [Out-Host](Out-Host.md) or using `Format-*` cmdlets and the -[Format.ps1xml](About/about_Format.ps1xml.md) file to control formatting. +PowerShell automatically adds `Out-Default` to the end of every top-level interactive pipeline. +`Out-Default` passes the objects it receives to the PowerShell format system. Then, it writes the +formatted output to the console. This cmdlet isn't intended to be used by the end user. ## EXAMPLES @@ -82,7 +67,7 @@ Accept wildcard characters: False ### -Transcript -Determines whether the output should be sent to PowerShell's transcription services. +When you use this parameter, the output is only sent to the PowerShell transcript. ```yaml Type: System.Management.Automation.SwitchParameter diff --git a/reference/7.5/Microsoft.PowerShell.Core/Out-Host.md b/reference/7.5/Microsoft.PowerShell.Core/Out-Host.md index 87f05c93b095..7a209ff119a1 100644 --- a/reference/7.5/Microsoft.PowerShell.Core/Out-Host.md +++ b/reference/7.5/Microsoft.PowerShell.Core/Out-Host.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 12/31/2022 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-host?view=powershell-7.5&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Host @@ -27,10 +27,9 @@ The `Out-Host` cmdlet sends output to the PowerShell host for display. The host at the command line. Because `Out-Host` is the default, you don't have to specify it unless you want to use its parameters. -`Out-Host` is automatically appended to every command that is executed. It passes the output of the -pipeline to the host executing the command. `Out-Host` ignores ANSI escape sequences. The escape -sequences are handled by the host. `Out-Host` passes ANSI escape sequences to the host without -trying to interpret or change them. +`Out-Host` passes the output of the pipeline to the host executing the command. `Out-Host` ignores +ANSI escape sequences. The escape sequences are handled by the host. `Out-Host` passes ANSI escape +sequences to the host without trying to interpret or change them. ## EXAMPLES @@ -89,14 +88,14 @@ Accept wildcard characters: False ### -Paging -Indicates that `Out-Host` displays one page of output at a time, and waits for user input before the -remaining pages are displayed. By default, all the output is displayed on a single page. The page -size is determined by the characteristics of the host. +Indicates that `Out-Host` displays one page of output at a time. The page size is determined by the +characteristics of the host. -Press the Space bar to display the next page of output or the Enter key to -view the next line of output. Press Q to quit. +After outputting the first page, the command waits for user input before the remaining pages are +displayed. Press the Spacebar to display the next page of output or the Enter +key to view the next line of output. Press Q to quit. -**Paging** is similar to the **more** command. +Using **Paging** is similar to using the **more** command. > [!NOTE] > The **Paging** parameter isn't supported by the PowerShell ISE host. @@ -139,20 +138,22 @@ PowerShell includes the following aliases for `Out-Host`: - All platforms: - `oh` -The **Paging** parameter isn't supported by all PowerShell hosts. For example, if you use the -**Paging** parameter in the PowerShell ISE, the following error is displayed: -`out-lineoutput : The method or operation is not implemented.` +Not all PowerShell hosts support the **Paging** parameter. For example, if you use the **Paging** +parameter in the Windows PowerShell ISE, the following error is displayed: + +> out-lineoutput : The method or operation is not implemented. The cmdlets that contain the **Out** verb, `Out-`, don't format objects. They render objects 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 don't have parameters for names or file paths. To send data to an `Out-` cmdlet, -use the pipeline to send a PowerShell command's output to the cmdlet. Or, you can store data in a -variable and use the **InputObject** parameter to pass the data to the cmdlet. +The `Out-` cmdlets don't read input from files. To send data to an `Out-` cmdlet, use the pipeline +to send data to the cmdlet. Or, you can store data in a variable and use the **InputObject** +parameter to pass the data to the cmdlet. -`Out-Host` sends data, but it doesn't produce any output objects. If you pipeline the output of -`Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects have been specified. +`Out-Host` sends data to the host only. Tt doesn't produce output objects to the pipeline. If you +pipeline the output of `Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects +have been specified. ## RELATED LINKS diff --git a/reference/7.6/Microsoft.PowerShell.Core/Out-Default.md b/reference/7.6/Microsoft.PowerShell.Core/Out-Default.md index 52a215682028..c6c9a4c12717 100644 --- a/reference/7.6/Microsoft.PowerShell.Core/Out-Default.md +++ b/reference/7.6/Microsoft.PowerShell.Core/Out-Default.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 02/07/2023 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-default?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Default @@ -20,24 +20,9 @@ Out-Default [-Transcript] [-InputObject ] [] ## DESCRIPTION -PowerShell automatically adds `Out-Default` to the end of every pipeline. `Out-Default` decides how -to format and output the object stream. If the object stream is a stream of strings, `Out-Default` -pipes these directly to `Out-Host` which calls the appropriate APIs provided by the host. If the -object stream does not contain strings, `Out-Default` inspects the object to determine what to do. -First it looks at the object type and determines whether there is a registered _view_ for this -object type. - -PowerShell defines an XML schema and a mechanism (the `Update-FormatData` cmdlet) where anyone can -register views for an object type. You can specify **wide**, **list**, **table**, or **custom** -views for any object type. The views specify which properties to display and how they should be -displayed. If a view is registered, it defines which formatter to use. So if the registered view is -a **table** view, `Out-Default` streams the objects to `Format-Table | Out-Host`. `Format-Table` -transforms the objects into a stream of Formatting records (driven by the data in the view -definition) and `Out-Host` transforms the formatting records into calls on the Host interface. - -This cmdlet isn't intended to be used by the end user. Other cmdlets are recommended for controlling -output like [Out-Host](Out-Host.md) or using `Format-*` cmdlets and the [Format.ps1xml](About/about_format.ps1xml.md) -file to control formatting. +PowerShell automatically adds `Out-Default` to the end of every top-level interactive pipeline. +`Out-Default` passes the objects it receives to the PowerShell format system. Then, it writes the +formatted output to the console. This cmdlet isn't intended to be used by the end user. ## EXAMPLES @@ -82,7 +67,7 @@ Accept wildcard characters: False ### -Transcript -Determines whether the output should be sent to PowerShell's transcription services. +When you use this parameter, the output is only sent to the PowerShell transcript. ```yaml Type: System.Management.Automation.SwitchParameter @@ -100,7 +85,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS diff --git a/reference/7.6/Microsoft.PowerShell.Core/Out-Host.md b/reference/7.6/Microsoft.PowerShell.Core/Out-Host.md index e80ccdc9ba13..e9c710d4e147 100644 --- a/reference/7.6/Microsoft.PowerShell.Core/Out-Host.md +++ b/reference/7.6/Microsoft.PowerShell.Core/Out-Host.md @@ -2,7 +2,7 @@ external help file: System.Management.Automation.dll-Help.xml Locale: en-US Module Name: Microsoft.PowerShell.Core -ms.date: 12/31/2022 +ms.date: 04/17/2025 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/out-host?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 title: Out-Host @@ -27,10 +27,9 @@ The `Out-Host` cmdlet sends output to the PowerShell host for display. The host at the command line. Because `Out-Host` is the default, you don't have to specify it unless you want to use its parameters. -`Out-Host` is automatically appended to every command that is executed. It passes the output of the -pipeline to the host executing the command. `Out-Host` ignores ANSI escape sequences. The escape -sequences are handled by the host. `Out-Host` passes ANSI escape sequences to the host without -trying to interpret or change them. +`Out-Host` passes the output of the pipeline to the host executing the command. `Out-Host` ignores +ANSI escape sequences. The escape sequences are handled by the host. `Out-Host` passes ANSI escape +sequences to the host without trying to interpret or change them. ## EXAMPLES @@ -89,14 +88,14 @@ Accept wildcard characters: False ### -Paging -Indicates that `Out-Host` displays one page of output at a time, and waits for user input before the -remaining pages are displayed. By default, all the output is displayed on a single page. The page -size is determined by the characteristics of the host. +Indicates that `Out-Host` displays one page of output at a time. The page size is determined by the +characteristics of the host. -Press the Space bar to display the next page of output or the Enter key to -view the next line of output. Press Q to quit. +After outputting the first page, the command waits for user input before the remaining pages are +displayed. Press the Spacebar to display the next page of output or the Enter +key to view the next line of output. Press Q to quit. -**Paging** is similar to the **more** command. +Using **Paging** is similar to using the **more** command. > [!NOTE] > The **Paging** parameter isn't supported by the PowerShell ISE host. @@ -117,7 +116,8 @@ Accept wildcard characters: False This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, --WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +-WarningAction, and -WarningVariable. For more information, see +[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS @@ -138,20 +138,22 @@ PowerShell includes the following aliases for `Out-Host`: - All platforms: - `oh` -The **Paging** parameter isn't supported by all PowerShell hosts. For example, if you use the -**Paging** parameter in the PowerShell ISE, the following error is displayed: -`out-lineoutput : The method or operation is not implemented.` +Not all PowerShell hosts support the **Paging** parameter. For example, if you use the **Paging** +parameter in the Windows PowerShell ISE, the following error is displayed: + +> out-lineoutput : The method or operation is not implemented. The cmdlets that contain the **Out** verb, `Out-`, don't format objects. They render objects 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 don't have parameters for names or file paths. To send data to an `Out-` cmdlet, -use the pipeline to send a PowerShell command's output to the cmdlet. Or, you can store data in a -variable and use the **InputObject** parameter to pass the data to the cmdlet. +The `Out-` cmdlets don't read input from files. To send data to an `Out-` cmdlet, use the pipeline +to send data to the cmdlet. Or, you can store data in a variable and use the **InputObject** +parameter to pass the data to the cmdlet. -`Out-Host` sends data, but it doesn't produce any output objects. If you pipeline the output of -`Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects have been specified. +`Out-Host` sends data to the host only. Tt doesn't produce output objects to the pipeline. If you +pipeline the output of `Out-Host` to the `Get-Member` cmdlet, `Get-Member` reports that no objects +have been specified. ## RELATED LINKS