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 configurações de sessão personalizadas para 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 recursos diferentes em um único ponto de extremidade restrito com base na associação ao grupo. O cmdlet Get-PSSessionCapability reduz a complexidade na auditoria destes endpoints, permitindo-lhe determinar as capacidades exatas atribuídas a um utilizador.
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 executando Get-Command no ponto de extremidade especificado. Quando executado com o parâmetro Full, este cmdlet retorna um objeto InitialSessionState. Este objeto contém detalhes sobre o espaço de execução do PowerShell com o qual o usuário especificado interagiria para o ponto de extremidade especificado. 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 utilizador
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'Este exemplo retorna os comandos disponíveis para o utilizador CONTOSO\User ao conectar-se ao endpoint restrito Endpoint1 no computador local.
Exemplo 2: Obter detalhes sobre um espaço de execução para um usuário
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -FullEste exemplo retorna detalhes sobre o espaço de execução com o qual o usuário CONTOSO\User interagiria ao se conectar ao ponto de extremidade restrito Endpoint1.
Parâmetros
-ConfigurationName
Especifica a configuração de sessão restrita (endpoint) que está a inspecionar.
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Full
Indica que este cmdlet retorna todo o estado inicial da sessão para o utilizador especificado no ponto de extremidade restrito especificado.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Username
Especifica o usuário cujos recursos você está inspecionando.
| Tipo: | String |
| Position: | 1 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
