Compartilhar via

Set-Clipboard

  • Referência
Módulo:
Microsoft.PowerShell.Management

Define a entrada atual da área de transferência do Windows.

Sintaxe

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

O Set-Clipboard cmdlet define a entrada atual da área de transferência do Windows.

Exemplos

Exemplo 1: Copiar texto para a área de transferência

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

Exemplo 2: Copiar o conteúdo de um diretório para a área de transferência

Este exemplo copia o conteúdo da pasta especificada para a área de transferência.

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

Exemplo 3: Copiar o conteúdo de um arquivo para a área de transferência

Este exemplo canaliza o conteúdo de um arquivo, uma chave ssh pública, para a área de transferência. Em seguida, a chave pode ser colada em outro aplicativo, como o GitHub.

Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard

Parâmetros

-Append

Indica que o cmdlet deve ser adicionado à área de transferência em vez de substituí-lo. Por padrão, o cmdlet limpa o conteúdo atual da área de transferência e o define como o novo conteúdo. Quando esse parâmetro é especificado, o cmdlet acrescenta o novo conteúdo após uma nova linha ao conteúdo atual.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AsHtml

Indica que o cmdlet renderiza o conteúdo como HTML para a área de transferência.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LiteralPath

Especifica o caminho para o item que é copiado para a área de transferência. Ao contrário de Path, o valor de LiteralPath é usado exatamente como está escrito. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples instruem o Windows PowerShell a nunca interpretar caracteres como sequências de escape.

Tipo:String[]
Aliases:PSPath
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica o caminho para o item que é copiado para a área de transferência. Caracteres curinga são permitidos.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Value

Especifica, como uma matriz de cadeia de caracteres, o conteúdo a ser copiado para a área de transferência.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres contendo o conteúdo a ser definido para a área de transferência para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Set-Clipboard:

  • scb

Em casos raros, ao usar Set-Clipboard muitas vezes em rápida sucessão, como em um loop, a área de transferência não é atualizada ou você recebe um erro ExternalException . Isso pode ser causado quando você tenta definir a área de transferência e ela ainda está em uso. Isso pode tentar evitar esse problema adicionando Start-Sleep -Milliseconds 100 ao loop.