Get-PSSessionCapability

  • Referensi
Modul:
Microsoft.PowerShell.Core

Mendapatkan kemampuan pengguna tertentu pada konfigurasi sesi yang dibatasi.

Sintaks

Get-PSSessionCapability
   [-ConfigurationName] <String>
   [-Username] <String>
   [-Full]
   [<CommonParameters>]

Deskripsi

Get-PSSessionCapability Cmdlet mendapatkan kemampuan pengguna tertentu pada konfigurasi sesi yang dibatasi. Gunakan cmdlet ini untuk mengaudit konfigurasi sesi yang disesuaikan untuk pengguna.

Mulai dari 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. Get-PSSessionCapability Cmdlet mengurangi kompleksitas saat mengaudit titik akhir ini dengan memungkinkan Anda menentukan kemampuan yang tepat yang diberikan kepada pengguna.

Secara default, Get-PSSessionCapability cmdlet mengembalikan daftar perintah yang dapat dijalankan pengguna yang ditentukan di titik akhir yang ditentukan. Ini setara dengan pengguna yang berjalan Get-Command di titik akhir yang ditentukan. Saat dijalankan dengan parameter Lengkap , cmdlet ini mengembalikan objek InitialSessionState . Objek ini berisi detail tentang runspace PowerShell yang akan berinteraksi dengan 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 saat menyambungkan ke titik akhir yang dibatasi Endpoint1 di komputer lokal.

Contoh 2: Mendapatkan detail tentang runspace untuk pengguna

Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full

Contoh ini mengembalikan detail tentang runspace yang akan berinteraksi dengan CONTOSO\User pengguna saat menyambungkan ke titik akhir yang dibatasi Endpoint1.

Parameter

-ConfigurationName

Menentukan konfigurasi sesi yang dibatasi (titik akhir) yang Anda periksa.

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

-Full

Menunjukkan bahwa cmdlet ini mengembalikan seluruh status sesi awal untuk pengguna yang ditentukan pada titik akhir yang dibatasi yang ditentukan.

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

-Username

Menentukan pengguna yang kemampuannya Anda periksa.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Output

AliasInfo

FunctionInfo

InitialSessionState