Compartir a través de

Set-Clipboard

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Establece la entrada actual del Portapapeles de Windows.

Sintaxis

Set-Clipboard
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Value] <String[]>
   [-Append]
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -Path <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Clipboard
   [-Append]
   -LiteralPath <String[]>
   [-AsHtml]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El Set-Clipboard cmdlet establece la entrada actual del Portapapeles de Windows.

Ejemplos

Ejemplo 1: Copiar texto en el Portapapeles

Set-Clipboard -Value "This is a test string"

Ejemplo 2: Copiar el contenido de un directorio en el Portapapeles

En este ejemplo se copia el contenido de la carpeta especificada en el Portapapeles.

Set-Clipboard -Path "C:\Staging\"

Ejemplo 3: 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

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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsHtml

Indica que el cmdlet representa el contenido como HTML en el Portapapeles.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LiteralPath

Especifica la ruta de acceso al elemento que se copia en el Portapapeles. A diferencia de Path, el valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a Windows PowerShell que no interprete ningún carácter como secuencia de escape.

Tipo:String[]
Alias:PSPath
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso al elemento que se copia en el Portapapeles. Se permite el uso de caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Value

Especifica, como matriz de cadenas, el contenido que se va a copiar en el Portapapeles.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contiene el contenido que se va a establecer en el Portapapeles a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Windows PowerShell incluye los siguientes alias para Set-Clipboard:

  • scb

En raras ocasiones, cuando se usa Set-Clipboard muchas veces en sucesión rápida, como en un bucle, el Portapapeles no se actualiza o recibe un error externalException . Esto puede deberse a que intenta establecer el Portapapeles y todavía está en uso. Esto puede intentar evitar este problema agregando Start-Sleep -Milliseconds 100 al bucle .