Get-PSSessionCapability
Obtém os recursos de um usuário específico em uma configuração de sessão restrita.
Sintaxe
Default (Default)
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 capacidades em um único endpoint 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 as capacidades específicas concedidas 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 executar 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
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
Este exemplo retorna os comandos disponíveis para o usuário CONTOSO\User ao conectar-se ao endpoint restrito Endpoint1 no computador local.
Exemplo 2: obter informações sobre um runspace para um usuário
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full
Este exemplo retorna detalhes sobre o runspace 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 limitada (endpoint) que você está inspecionando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Username
Especifica o usuário cujos recursos você está inspecionando.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
