Compartilhar via

Enable-PSSessionConfiguration

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

Habilita as configurações de sessão no computador local.

Sintaxe

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet permite configurações de sessão registradas que foram desabilitadas, como usando os cmdlets ou ou o parâmetro AccessMode de . Esse é um cmdlet avançado que foi projetado para ser usado pelos administradores do sistema para gerenciar configurações de sessão personalizadas para seus usuários.

Sem parâmetros, Enable-PSSessionConfiguration habilita a configuração de Microsoft.PowerShell, que é a configuração padrão usada para sessões.

Enable-PSSessionConfiguration remove a configuração de Deny_All do descritor de segurança das configurações de sessão afetadas, ativa o ouvinte que aceita solicitações em qualquer endereço IP e reinicia o serviço WinRM. A partir do PowerShell 3.0, Enable-PSSessionConfiguration também define o valor da propriedade Enabled da configuração de sessão (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) como True. No entanto, Enable-PSSessionConfiguration não remove ou altera a configuração do descritor de segurança Network_Deny_All (AccessMode=Local) que permite que apenas os usuários do computador local usem para a configuração da sessão.

Exemplos

Exemplo 1: reabilitar a sessão padrão

Este exemplo habilita novamente o Microsoft.PowerShell configuração de sessão padrão no computador.

Enable-PSSessionConfiguration

Exemplo 2: habilitar novamente as sessões especificadas

Este exemplo habilita novamente o do MaintenanceShell e as configurações de sessão do AdminShell no computador.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Exemplo 3: habilitar novamente todas as sessões

Este exemplo habilita novamente todas as configurações de sessão no computador. Esses comandos são equivalentes. Portanto, você pode usar qualquer um.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration não gerará um erro se você habilitar uma configuração de sessão que já está habilitada.

Exemplo 4: reabilitar uma sessão e especificar um novo descritor de segurança

Este exemplo habilita novamente a configuração de sessão MaintenanceShell e especifica um novo descritor de segurança para a configuração.

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que o cmdlet não solicita confirmação e reinicia o serviço WinRM sem solicitar. Reiniciar o serviço torna a alteração de configuração eficaz.

Para impedir uma reinicialização e suprimir o prompt de reinicialização, use o parâmetro NoServiceRestart.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica os nomes das configurações de sessão a serem habilitadas. Insira um ou mais nomes de configuração. Caracteres curinga são permitidos.

Você também pode canalizar uma cadeia de caracteres que contém um nome de configuração ou um objeto de configuração de sessão para Enable-PSSessionConfiguration.

Se você omitir esse parâmetro, Enable-PSSessionConfiguration habilitará a configuração de sessão Microsoft.PowerShell.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-NoServiceRestart

Indica que o cmdlet não reinicia o serviço.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecurityDescriptorSddl

Especifica um descritor de segurança pelo qual esse cmdlet substitui o descritor de segurança na configuração da sessão.

Se você omitir esse parâmetro, Enable-PSSessionConfiguration excluirá apenas o item de negação do descritor de segurança.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SkipNetworkProfileCheck

Indica que esse cmdlet habilita a configuração de sessão quando o computador está em uma rede pública. Esse parâmetro habilita uma regra de firewall para redes públicas que permite o acesso remoto somente de computadores na mesma sub-rede local. Por padrão, Enable-PSSessionConfiguration falha em uma rede pública.

Esse parâmetro foi projetado para versões de cliente do sistema operacional Windows. As versões de servidor do sistema operacional Windows têm uma regra de firewall de sub-rede local para redes públicas. No entanto, se a regra de firewall de sub-rede local estiver desabilitada em uma versão do servidor do sistema operacional Windows, esse parâmetro a habilitará novamente.

Para remover a restrição de sub-rede local e habilitar o acesso remoto de todos os locais em redes públicas, use o cmdlet Set-NetFirewallRule no módulo NetSecurity. Para obter mais informações, consulte Enable-PSRemoting.

Esse parâmetro foi introduzido no PowerShell 3.0.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Você pode canalizar um objeto de configuração de sessão ou uma cadeia de caracteres que contém o nome de uma configuração de sessão para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhum objeto.

Observações

Para usar esse cmdlet, você deve iniciar o PowerShell usando a opção Executar como administrador.