Get-PSSessionCapability

  • Referência
Módulo:
Microsoft.PowerShell.Core

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 Get-PSSessionCapability cmdlet obtém os recursos de um usuário específico em uma configuração de sessão restrita. Use esse 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 conceder aos usuários diferentes recursos em um único ponto de extremidade restrito com base na associação ao grupo. O Get-PSSessionCapability cmdlet 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 Get-PSSessionCapability cmdlet retorna uma lista de comandos que o usuário especificado pode executar no ponto de extremidade especificado. Isso é equivalente ao usuário em execução Get-Command no ponto de extremidade especificado. Quando executado com o parâmetro Full , esse cmdlet retorna um objeto InitialSessionState . Esse objeto contém detalhes sobre o runspace 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 usuário

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 do Ponto de Extremidade1 no computador local.

Exemplo 2: Obter detalhes 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 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 de 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

Saídas

AliasInfo

FunctionInfo

InitialSessionState