다음을 통해 공유


Set-Clipboard

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

구문

Default (기본값)

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

Description

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

비고

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_CLIENT 또는 $Env:SSH_TTY 환경 변수의 값을 확인하여 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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AsOSC52

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

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

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:ToLocalhost

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PassThru

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Value

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

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

출력

None

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

참고

PowerShell에는 Set-Clipboard에 대한 다음과 같은 별칭들이 포함되어 있습니다.

  • 모든 플랫폼:
    • scb

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