Get-PSSessionCapability
Obtém os recursos de um usuário específico em uma configuração de sessão restrita.
Sintaxe
Default (Predefinição)
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 Windows 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 usuário CONTOSO\User ao se conectar ao ponto de extremidade 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' -Full
Este 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Full
Indica que este cmdlet retorna todo o estado inicial da sessão para o utilizador especificado no ponto de extremidade restrito especificado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Username
Especifica o usuário cujos recursos você está inspecionando.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
