Enable-PSSessionConfiguration

Artigo
10/30/2009

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

Nenhum

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.

Consulte também

Conceitos

about_Session_Configurations
Disable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider

Compartilhar via