Enable-PSSessionConfiguration
Habilita as configurações de sessão no computador local.
Syntax
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet só está disponível na plataforma Windows.
O Enable-PSSessionConfiguration
cmdlet habilita configurações de sessão registradas que foram desabilitadas, como usando os Disable-PSSessionConfiguration
cmdlets ou Disable-PSRemoting
o parâmetro AccessMode de Register-PSSessionConfiguration
. Esse é um cmdlet avançado projetado para ser utilizado por administradores de sistema a fim de gerenciar configurações de sessão personalizadas para seus usuários.
Sem parâmetros, Enable-PSSessionConfiguration
habilita a configuração do 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 da sessão (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled
) como True. No entanto, Enable-PSSessionConfiguration
não remove nem 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 a configuração da sessão.
Exemplos
Exemplo 1: Reativar a sessão padrão
Este exemplo reativa a configuração de sessão padrão do Microsoft.PowerShell no computador.
Enable-PSSessionConfiguration
Exemplo 2: Reativar sessões especificadas
Este exemplo reativa as configurações de sessão MaintenanceShell e AdminShell no computador.
Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell
Exemplo 3: Reativar todas as sessões
Este exemplo reativa todas as configurações de sessão no computador. Esses comandos são equivalentes. Portanto, você pode usar qualquer um deles.
Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration
Enable-PSSessionConfiguration
não gera um erro se você habilitar uma configuração de sessão que já está habilitada.
Exemplo 4: Reativar uma sessão e especificar um novo descritor de segurança
Este exemplo reativa a configuração da 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indica que o cmdlet não solicita confirmação e reinicia o serviço WinRM sem solicitar. Reiniciar o serviço faz a com que a alteração da configuração entre em vigor.
Para impedir uma reinicialização e suprimir o prompt de reinicialização, use o parâmetro NoServiceRestart .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica os nomes das configurações de sessão a habilitar. 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 do Microsoft.PowerShell .
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoServiceRestart
Indica que o cmdlet não reinicia o serviço.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
Especifica um descritor de segurança com o 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 negar tudo do descritor de segurança.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipNetworkProfileCheck
Indica que esse cmdlet habilita a configuração da sessão quando o computador está em uma rede pública. Este parâmetro habilita uma regra de firewall para redes públicas que permite o acesso remoto somente por meio 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 de servidor do sistema operacional Windows, esse parâmetro a reativará.
Para remover a restrição de sub-rede local e habilitar o acesso remoto de todos os locais em redes públicas, use o Set-NetFirewallRule
cmdlet no módulo NetSecurity. Para obter mais informações, consulte Enable-PSRemoting
.
Esse parâmetro foi introduzido no PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
Você pode canalizar um objeto de configuração de sessão para esse cmdlet.
Você pode canalizar uma cadeia de caracteres que contém o nome de uma configuração de sessão para esse cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
Esse cmdlet só está disponível em plataformas Windows.
Para usar esse cmdlet, você deve iniciar o PowerShell usando a opção Executar como administrador .
Links Relacionados
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- Provedor WSMan
- about_Session_Configurations
- about_Session_Configuration_Files
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de