Share via

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.

Syntax

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 que você conceda aos usuários recursos diferentes 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 . 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. Ele inclui informações como Modo de Idioma, Política de Execução e Variáveis de Ambiente.

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 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 (ponto de extremidade) que você está inspecionando.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

Especifica o usuário cujos recursos você está inspecionando.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Saídas

AliasInfo

FunctionInfo

InitialSessionState