Get-PSSessionCapability
Obtém os recursos de um usuário específico em uma configuração de sessão restrita.
Sintaxe
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>] Description
O cmdlet Get-PSSessionCapability obtém os recursos de um usuário específico em uma configuração de sessão restrita. Use este cmdlet para auditar as configurações de sessão personalizadas para os usuários.
A partir do Windows PowerShell 5.0, você pode usar a propriedade RoleDefinitions em um arquivo de configuração de sessão (.pssc). O uso dessa propriedade permite que você conceda aos usuários diferentes recursos em um único ponto de extremidade restrito com base na associação de grupo. O cmdlet Get-PSSessionCapability reduz a complexidade ao auditar esses pontos de extremidade, permitindo que você determine os recursos exatos concedidos a um usuário.
Por padrão, o cmdlet Get-PSSessionCapability retorna uma lista de comandos que o usuário especificado pode executar no ponto de extremidade especificado. Isso é equivalente ao usuário que executa Get-Command no ponto de extremidade especificado. Quando executado com o parâmetro Full, esse cmdlet retorna um objeto InitialSessionState. Este objeto contém detalhes sobre o runspace do Windows PowerShell com o qual o usuário especificado interagiria para o ponto de extremidade especificado. Ele inclui informações como modo de linguagem, política de execução e variáveis ambientais.
Exemplos
Exemplo 1: Obter comandos disponíveis para um usuário
PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\EvanNa"Este exemplo retorna os comandos disponíveis para o usuário CONTOSO\EvanNa ao se conectar ao ponto de extremidade restrito endpoint1 no computador local.
Exemplo 2: obter detalhes sobre um runspace para um usuário
PS C:\> Get-PSSessionCapability -ConfigurationName "Endpoint1" -Username "CONTOSO\PattiFul" -FullEsse comando retorna detalhes sobre o runspace com o qual o usuário CONTOSO\PattiFul interagiria ao se conectar ao ponto de extremidade restrito endpoint1.
Parâmetros
-ConfigurationName
Especifica a configuração de sessão restrita (ponto de extremidade) que você está inspecionando.
| Tipo: | String |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Full
Indica que esse cmdlet retorna todo o estado da sessão inicial para o usuário especificado no ponto de extremidade restrito especificado.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Username
Especifica o usuário cujos recursos você está inspecionando.
| Tipo: | String |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |