Partilhar via

Set-Clipboard

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

Define a entrada atual da área de transferência do 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

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 ficheiro 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í-la. Por padrão, o cmdlet limpa o conteúdo atual da área de transferência e o define para 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.

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

-AsHtml

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

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

-Confirm

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

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

-LiteralPath

Especifica o caminho para o item 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 curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar nenhum caractere como sequências de escape.

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

-Path

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

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

-Value

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

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

String

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

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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.