Set-Clipboard
Establece el contenido del Portapapeles.
Sintaxis
Default (Es el valor predeterminado).
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Set-Clipboard establece el contenido del Portapapeles.
Nota:
En Linux, este cmdlet requiere que la utilidad xclip esté en la ruta. En macOS, este cmdlet usa la utilidad pbcopy.
Ejemplos
Ejemplo 1: Copiar texto en el Portapapeles
Set-Clipboard -Value "This is a test string"
Ejemplo 2: Copiar el contenido de un archivo en el Portapapeles
En este ejemplo se canaliza el contenido de un archivo, una clave ssh pública, al Portapapeles. A continuación, la clave se puede pegar en otra aplicación, como GitHub.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
Ejemplo 3: Copiar texto en el Portapapeles del host local a través de una sesión remota ssh
El parámetro AsOSC52 permite establecer el portapapeles de la máquina local cuando está conectada a una sesión remota a través de SSH.
Set-Clipboard -Value "This is a test string" -AsOSC52
Ejemplo 4: Establecer el valor predeterminado del parámetro **AsOSC52**
Puede detectar si está conectado a una sesión remota a través de SSH comprobando el valor de las variables de entorno $Env:SSH_CLIENT o $Env:SSH_TTY. Si se establece alguna de estas variables, se conecta a una sesión remota a través de SSH. Puede usar esta información para establecer el valor predeterminado del parámetro AsOSC52. Agregue una de las líneas siguientes al script de perfil de PowerShell.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY
Para obtener más información sobre $PSDefaultParameterValues, consulte about_Parameters_Default_Values.
Parámetros
-Append
Indica que el cmdlet debe agregar al portapapeles en lugar de reemplazarlo. De forma predeterminada, el cmdlet borra el contenido actual del Portapapeles y lo establece en el nuevo contenido. Cuando se especifica este parámetro, el cmdlet anexa el nuevo contenido después de una nueva línea al contenido actual.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AsOSC52
Cuando se conecta a una sesión remota a través de SSH, Set-Clipboard establece el Portapapeles de la máquina remota, no el host local. Al usar este parámetro, Set-Clipboard emplea la secuencia de escape ANSI OSC52 para configurar el portapapeles de la máquina local.
Para que esta característica funcione, la aplicación terminal debe admitir la secuencia de escape ANSI de OSC52. El Terminal de Windows admite esta característica.
Este parámetro se agregó en PowerShell 7.4.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | ToLocalhost |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PassThru
Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Value
Los valores de cadena que se van a agregar al portapapeles.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
String
Puede canalizar una cadena que contiene el contenido que desea establecer en el portapapeles.
Salidas
None
Este cmdlet no devuelve ninguna salida.
Notas
PowerShell incluye los siguientes alias para Set-Clipboard:
- Todas las plataformas:
scb
Se ha agregado compatibilidad con este cmdlet en macOS en la versión de PowerShell 7.0.0.
