Habilita as configurações de sessão no computador local.
Sintaxe
Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Enable-PSSessionConfiguration reabilita configurações de sessão registradas que foram desabilitadas com o cmdlet Disable-PSSessionConfiguration. Esse é um cmdlet avançado, projetado para ser usado pelos administradores de sistema para gerenciar as configurações de sessão personalizadas para seus usuários.
Sem parâmetros, Enable-PSSessionConfiguration reabilita a configuração Microsoft.PowerShell, que é a configuração padrão usada para sessões.
Esse cmdlet executa os seguintes operações para cada configuração habilitada:
-- Remove a configuração "negar todos" do descritor de segurança da configuração ou substitui o descritor de segurança por um que você especificar.
-- Ativa a escuta que aceita solicitações em qualquer endereço IP.
-- Reinicia o serviço WinRM.
O cmdlet Enable-PSSessionConfiguration chama o cmdlet Set-WSManQuickConfig. Entretanto, ele não deve ser usado para habilitar a comunicação remota no computador. Em vez disso, use o mais cmdlet abrangente, Enable-PSRemoting.
Parâmetros
-Force
Suprime todos os avisos de usuário e reinicia o serviço WinRM sem aviso. A reinicialização do serviço torna efetiva a alteração da configuração.
Para impedir a reinicialização e suprimir o aviso de reinicialização, use o parâmetro NoServiceRestart.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Name <string[]>
Especifica os nomes de configurações de sessão a serem habilitadas. Insira um ou mais nomes de configuração. Os caracteres curinga são permitidos.
Você também poderá canalizar uma cadeia de caracteres que contenha 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.
|
Necessário? |
false |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
|
Aceitar caracteres curinga? |
true |
-SecurityDescriptorSDDL <string>
Substitui o descritor de segurança na configuração de sessão pelo descritor de segurança especificado.
Se você omitir esse parâmetro, Enable-PSSessionConfiguration apenas excluirá o item "negar todos" do descritor de segurança.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String Você poderá canalizar um objeto de configuração de sessão ou uma cadeia de caracteres que contenha o nome de uma configuração de sessão para Enable-PSSessionConfiguration. |
|
Saídas |
None Este cmdlet não retorna nenhum objeto. |
Observações
Para executar esse cmdlet no Windows Vista, no Windows Server 2008 e em versões mais recentes do Windows, inicie o Windows PowerShell com a opção "Executar como administrador".
Exemplo 1
C:\PS>Enable-PSSessionConfiguration Descrição ----------- Esse comando reabilita a configuração de sessão padrão Microsoft.PowerShell no computador remoto.
Exemplo 2
C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell Descrição ----------- Esse comando reabilita as configurações de sessão MaintenanceShell e AdminShell no computador.
Exemplo 3
C:\PS>Enable-PSSessionConfiguration -name * C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration Descrição ----------- Esses comandos reabilitam todas as configurações de sessão no computador. Os comandos são equivalentes; portanto, você pode usar qualquer um dos dois. Enable-PSSessionConfiguration não gerará um erro se você habilitar uma configuração de sessão que já esteja habilitada.
Exemplo 4
C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P" Descrição ----------- Esse comando reabilita a configuração de sessão MaintenanceShell e especifica um novo descritor de segurança para a configuração.
See Also