Get-Clipboard
Gets the contents of the clipboard.
Syntax
Get-Clipboard
[-Raw]
[<CommonParameters>]
Description
The Get-Clipboard
cmdlet gets the contents of the clipboard as text. Multiple lines of text are
returned as an array of strings similar to Get-Content
.
Note
On Linux, this cmdlet requires the xclip
utility to be in the path. On macOS, this cmdlet uses
the pbpaste
utility.
Examples
Example 1: Get the content of the clipboard and display it to the command-line
In this example we have copied the text "hello" into the clipboard.
Get-Clipboard
hello
Parameters
-Raw
Gets the entire contents of the clipboard. Multiline text is returned as a single multiline string rather than an array of strings.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None
You can't pipe objects to this cmdlet.
Outputs
This cmdlet returns a string containing the contents of the clipboard.
Notes
PowerShell includes the following aliases for Get-Clipboard
:
- All platforms:
gcb
Support for this cmdlet on macOS was added in the PowerShell 7.0.0 release.