Compartilhar via

Enable-PSSessionConfiguration

Módulo:
Microsoft.PowerShell.Core Module

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

Sintaxe

Default (Padrão) 

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

Description

Este cmdlet só está disponível na plataforma Windows.

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 sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NoServiceRestart

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Você pode redirecionar um objeto de configuração de sessão para este cmdlet.

String

Você pode canalizar 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 nenhuma saída.

Observações

Este cmdlet está disponível apenas em plataformas Windows.

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