다음을 통해 공유


Set-Clipboard

클립보드의 내용을 설정합니다.

구문

Set-Clipboard
   [-Value] <string[]>
   [-Append]
   [-PassThru]
   [-AsOSC52]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

cmdlet은 Set-Clipboard 클립보드의 내용을 설정합니다.

참고 항목

Linux에서 이 cmdlet을 사용하려면 유틸리티가 xclip 경로에 있어야 합니다. macOS에서 이 cmdlet은 유틸리티를 pbcopy 사용합니다.

예제

예제 1: 클립보드에 텍스트 복사

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

예제 2: 파일 내용을 클립보드에 복사

다음은 공개 ssh 키인 파일의 내용을 클립보드로 파이프하는 예제입니다. 그런 다음 GitHub와 같은 다른 애플리케이션에 키를 붙여넣을 수 있습니다.

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

예제 3: SSH 원격 세션을 통해 로컬 호스트의 클립보드에 텍스트 복사

AsOSC52 매개 변수를 사용하면 SSH를 통해 원격 세션에 연결할 때 로컬 컴퓨터의 클립보드를 설정할 수 있습니다.

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

예제 4: **AsOSC52** 매개 변수의 기본값 설정

또는 $env:SSH_TTY 환경 변수의 $env:SSH_CLIENT 값을 확인하여 SSH를 통해 원격 세션에 연결되어 있는지 감지할 수 있습니다. 이러한 변수 중 하나가 설정되면 SSH를 통해 원격 세션에 연결됩니다. 이 정보를 사용하여 AsOSC52 매개 변수의 기본값을 설정할 수 있습니다 . PowerShell 프로필 스크립트에 다음 줄 중 하나를 추가합니다.

$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $env:SSH_TTY

자세한 $PSDefaultParameterValues내용은 about_Parameters_Default_Values 참조하세요.

매개 변수

-Append

cmdlet을 교체하는 대신 클립보드에 추가해야 함을 나타냅니다. 기본적으로 cmdlet은 클립보드에서 현재 콘텐츠를 지우고 새 콘텐츠로 설정합니다. 이 매개 변수를 지정하면 cmdlet은 현재 콘텐츠에 줄 바꿈 후 새 콘텐츠를 추가합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AsOSC52

SSH Set-Clipboard 를 통해 원격 세션에 연결된 경우 로컬 호스트가 아닌 원격 컴퓨터의 클립보드를 설정합니다. 이 매개 변수 Set-Clipboard 를 사용하는 경우 OSC52 ANSI 이스케이프 시퀀스를 사용하여 로컬 컴퓨터의 클립보드를 설정합니다.

이 기능이 작동하려면 터미널 애플리케이션이 OSC52 ANSI 이스케이프 시퀀스를 지원해야 합니다. Windows 터미널기능을 지원합니다.

이 매개 변수는 PowerShell 7.4에 추가되었습니다.

형식:SwitchParameter
별칭:ToLocalhost
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Value

클립보드에 추가할 문자열 값입니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

콘텐츠가 포함된 문자열을 이 cmdlet으로 클립보드로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Set-Clipboard

  • 모든 플랫폼:
    • scb

macOS에서 이 cmdlet에 대한 지원이 PowerShell 7.0.0 릴리스에 추가되었습니다.