Get-PSSessionCapability
Mendapatkan kemampuan pengguna tertentu pada konfigurasi sesi yang dibatasi.
Sintaks
Default (Default)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Deskripsi
cmdlet Get-PSSessionCapability mendapatkan kemampuan pengguna tertentu pada konfigurasi sesi yang dibatasi. Gunakan cmdlet ini untuk mengaudit konfigurasi sesi yang disesuaikan untuk pengguna.
Mulai windows PowerShell 5.0, Anda dapat menggunakan properti RoleDefinitions dalam file konfigurasi sesi (.pssc). Menggunakan properti ini memungkinkan Anda memberi pengguna kemampuan yang berbeda pada satu titik akhir yang dibatasi berdasarkan keanggotaan grup. cmdlet Get-PSSessionCapability mengurangi kompleksitas saat mengaudit titik akhir ini dengan memungkinkan Anda menentukan kemampuan yang tepat yang diberikan kepada pengguna.
Secara default, cmdlet Get-PSSessionCapability mengembalikan daftar perintah yang dapat dijalankan pengguna yang ditentukan di titik akhir yang ditentukan. Ini setara dengan pengguna yang menjalankan Get-Command di titik akhir yang ditentukan. Saat dijalankan dengan parameter Penuh, cmdlet ini mengembalikan objek InitialSessionState. Objek ini berisi detail tentang runspace PowerShell yang akan digunakan oleh pengguna yang ditentukan untuk titik akhir yang ditentukan. Ini termasuk informasi seperti Mode Bahasa, Kebijakan Eksekusi, dan Variabel Lingkungan.
Contoh
Contoh 1: Dapatkan perintah yang tersedia untuk pengguna
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
Contoh ini mengembalikan perintah yang tersedia untuk pengguna CONTOSO\User ketika terhubung ke titik akhir yang dibatasi Endpoint1 di komputer lokal.
Contoh 2: Memperoleh detail tentang sebuah runspace untuk pengguna
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full
Contoh ini mengembalikan detail tentang runspace yang akan digunakan oleh pengguna CONTOSO\User saat terhubung ke endpoint terkendali Endpoint1.
Parameter
-ConfigurationName
Menentukan konfigurasi sesi yang dibatasi (titik akhir) yang Anda periksa.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Full
Menunjukkan bahwa cmdlet ini mengembalikan seluruh status sesi awal untuk pengguna yang ditentukan pada titik akhir yang dibatasi yang ditentukan.
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 |
-Username
Menentukan pengguna yang kemampuannya Anda periksa.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 1 |
| Wajib: | True |
| 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.
