Set-Clipboard
Menyetel isi papan klip.
Sintaks
Default (Default)
Set-Clipboard
[-Value] <string[]>
[-Append]
[-PassThru]
[-AsOSC52]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Set-Clipboard mengatur konten clipboard.
Nota
Di Linux, cmdlet ini mengharuskan utilitas xclip berada di jalur . Di macOS, cmdlet ini menggunakan utilitas pbcopy.
Contoh
Contoh 1: Salin teks ke clipboard
Set-Clipboard -Value "This is a test string"
Contoh 2: Menyalin konten file ke clipboard
Contoh ini menyalurkan konten file, kunci ssh publik, ke clipboard. Kemudian, kunci dapat ditempelkan ke aplikasi lain, seperti GitHub.
Get-Content C:\Users\user1\.ssh\id_ed25519.pub | Set-Clipboard
Contoh 3: Salin teks ke clipboard host lokal melalui sesi jarak jauh SSH
Parameter AsOSC52 memungkinkan Anda mengatur clipboard komputer lokal saat terhubung ke sesi jarak jauh melalui SSH.
Set-Clipboard -Value "This is a test string" -AsOSC52
Contoh 4: Atur nilai default parameter **AsOSC52**
Anda dapat mendeteksi apakah Anda tersambung ke sesi jarak jauh melalui SSH dengan memeriksa nilai variabel lingkungan $Env:SSH_CLIENT atau $Env:SSH_TTY. Jika salah satu variabel ini diatur, maka Anda terhubung ke sesi jarak jauh melalui SSH. Anda dapat menggunakan informasi ini untuk mengatur nilai default parameter AsOSC52. Tambahkan salah satu baris berikut ke skrip profil PowerShell Anda.
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_CLIENT
$PSDefaultParameterValues['Set-Clipboard:AsOSC52'] = $Env:SSH_TTY
Untuk informasi selengkapnya tentang $PSDefaultParameterValues, lihat about_Parameters_Default_Values.
Parameter
-Append
Menunjukkan bahwa cmdlet harus ditambahkan ke clipboard alih-alih menggantinya. Secara default, cmdlet menghapus konten saat ini dari clipboard dan mengaturnya ke konten baru. Ketika parameter ini ditentukan, cmdlet menambahkan konten baru setelah baris baru ke konten saat ini.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-AsOSC52
Saat terhubung ke sesi jarak jauh melalui SSH, Set-Clipboard mengatur clipboard komputer jarak jauh, bukan host lokal. Saat Anda menggunakan parameter ini, Set-Clipboard menggunakan urutan escape OSC52 ANSI untuk mengatur clipboard komputer lokal.
Agar fitur ini berfungsi, aplikasi terminal Anda harus mendukung urutan escape OSC52 ANSI. Terminal Windows mendukung fitur ini.
Parameter ini ditambahkan di PowerShell 7.4.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | ToLocalhost |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-PassThru
Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Value
Nilai string yang akan ditambahkan ke clipboard.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
String
Anda dapat menyalurkan string yang berisi konten untuk diatur ke clipboard ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
PowerShell menyertakan alias berikut untuk Set-Clipboard:
- Semua platform:
scb
Dukungan untuk cmdlet ini di macOS ditambahkan dalam rilis PowerShell 7.0.0.
