Partilhar via

Enable-PSSessionConfiguration

Módulo:
Microsoft.PowerShell.Core Module

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

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet Enable-PSSessionConfiguration habilita configurações de sessão registradas que foram desabilitadas, como usando os cmdlets Disable-PSSessionConfiguration ou Disable-PSRemoting ou o parâmetro AccessMode de Register-PSSessionConfiguration. Este é um cmdlet avançado projetado para ser usado por administradores de sistema para gerenciar configurações de sessão personalizadas para seus usuários.

Sem parâmetros, habilita a configuração 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, também define o valor da propriedade Enabled da configuração da sessão () 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 para a configuração da sessão.

Exemplos

Exemplo 1: Reativar a sessão padrão

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

Enable-PSSessionConfiguration

Exemplo 2: Reativar sessões especificadas

Este exemplo reativa o MaintenanceShell e AdminShell configurações de sessão 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.

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á esteja habilitada.

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

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 efetiva.

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica os nomes das configurações de sessão a serem habilitadas. Insira um ou mais nomes de configuração. Caracteres coringa 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á o Microsoft.PowerShell configuração de sessão.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-NoServiceRestart

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 todos do descritor de segurança.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 permite uma regra de firewall para redes públicas que permite o acesso remoto apenas a partir de computadores na mesma sub-rede local. Por padrão, Enable-PSSessionConfiguration falha em uma rede pública.

Este 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 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 dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 canalizar 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

Este cmdlet não retorna nenhuma saída.

Notas

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