Compartir a través de

Set-Clipboard

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Establece la entrada actual del Portapapeles de Windows.

Syntax

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsHtml

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Value

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .