Disable-PSRemoting
Impede que usuários remotos executem comandos no computador local.
Sintaxe
Disable-PSRemoting
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
O cmdlet Disable-PSRemoting impede que os usuários em outros computadores executem comandos no computador local.
Disable-PSRemoting bloqueia o acesso remoto a todas as configurações de sessão no computador local. Isso impede que usuários remotos criem sessões temporárias ou persistentes no computador local. Disable-PSRemoting não impede que os usuários do computador local criem sessões (PSSessions) no computador local ou em computadores remotos.
Para habilitar novamente o acesso remoto a todas as configurações de sessão, use o cmdlet Enable-PSRemoting. Para habilitar o acesso remoto às configurações de sessão selecionadas, use o parâmetro AccessMode do cmdlet Set-PSSessionConfiguration. Você também pode usar os cmdlets Enable-PSSessionConfiguration e Disable-PSSessionConfiguration para habilitar e desabilitar as configurações de sessão para todos os usuários. Para obter mais informações sobre configurações de sessão, consulte about_Session_Configurations.
No Windows PowerShell 2.0, Disable-PSRemoting impede que todos os usuários criem sessões gerenciadas pelo usuário para o computador local. No Windows PowerShell 3.0, Disable-PSRemoting impede que os usuários em outros computadores criem sessões gerenciadas pelo usuário no computador local, mas permite que os usuários do computador local criem sessões de loopback gerenciadas pelo usuário.
Para executar esse cmdlet, inicie o Windows PowerShell com a opção Executar como administrador.
CUIDADO: em sistemas que têm o Windows PowerShell 3.0 e o mecanismo do Windows PowerShell 2.0, não use o Windows PowerShell 2.0 para executar os cmdlets Enable-PSRemoting e Disable-PSRemoting. Os comandos podem parecer bem-sucedidos, mas a comunicação remota não está configurada corretamente. Comandos remotos e tentativas posteriores de habilitar e desabilitar a comunicação remota provavelmente falharão.
Exemplos
Exemplo 1: impedir o acesso remoto a todas as configurações de sessão
PS C:\> Disable-PSRemotingEsse comando impede o acesso remoto a todas as configurações de sessão no computador.
Exemplo 2: impedir o acesso remoto a todas as configurações de sessão sem prompt de confirmação
PS C:\> Disable-PSRemoting -ForceEsse comando impede o acesso remoto a todas as configurações de sessão no computador sem solicitação.
Exemplo 3: efeitos da execução deste cmdlet
PS C:\> Disable-PSRemoting -Force
[ADMIN] PS C:\> New-PSSession -ComputerName localhost
Id Name ComputerName State Configuration Availability
-- ---- ------------ ----- ------------- ------------
1 Session1 Server02... Opened Microsoft.PowerShell Available
# On Server02 remote computer:
PS C:\> New-PSSession -ComputerName Server01
[SERVER01] Connecting to remote server failed with the following error
message : Access is denied. For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailedEste exemplo mostra o efeito do uso do cmdlet disable-PSRemoting
O primeiro comando usa o cmdlet Disable-PSRemoting para desabilitar todas as configurações de sessão registradas no computador Server01.
O segundo comando usa o cmdlet New-PSSession para criar uma sessão remota para o computador local (também conhecido como "loopback"). O comando é bem-sucedido.
O terceiro comando é executado no computador remoto Server02. O comando usa o cmdlet New-PSSession para criar uma sessão para o computador remoto Server01. Como o acesso remoto está desabilitado, o comando falha.
Exemplo 4: efeitos da execução deste cmdlet e Enable-PSRemoting
PS C:\> Disable-PSRemoting -force
[ADMIN] PS C:\> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto
Name Permission
---- ----------
microsoft.powershell NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell.workflow NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell32 NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.ServerManager NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
WithProfile NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
[ADMIN] PS C:\> Enable-PSRemoting -Force
WinRM already is set up to receive requests on this machine.
WinRM already is set up for remote management on this machine.
[ADMIN] PS C:\> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto
Name Permission
---- ----------
microsoft.powershell BUILTIN\Administrators AccessAllowed
microsoft.powershell.workflow BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed
microsoft.ServerManager BUILTIN\Administrators AccessAllowed
WithProfile BUILTIN\Administrators AccessAllowedEste exemplo mostra o efeito nas configurações de sessão do uso do Disable-PSRemoting e cmdlets Enable-PSRemoting.
O primeiro comando usa o cmdlet Disable-PSRemoting para desabilitar o acesso remoto a todas as configurações de sessão. O parâmetro Force suprime todos os prompts do usuário.
O segundo comando usa o cmdlet Get-PSSessionConfiguration para exibir as configurações de sessão no computador. O comando usa um operador de pipeline para enviar os resultados para um comando Format-Table, que exibe apenas as propriedades Nome e Permissão das configurações em uma tabela.
A saída mostra que somente usuários remotos têm acesso negado às configurações. Os membros do grupo Administradores no computador local têm permissão para usar as configurações de sessão. A saída também mostra que o comando afeta todas as configurações de sessão que incluem a configuração de sessão WithProfile criada pelo usuário.
O terceiro comando usa o cmdlet Enable-PSRemoting para habilitar novamente o acesso remoto a todas as configurações de sessão no computador. O comando usa o parâmetro Force para suprimir todos os prompts do usuário e reiniciar o serviço WinRM sem solicitar.
O quarto comando usa os cmdlets Get-PSSessionConfiguration e Format-Table para exibir os nomes e permissões das configurações de sessão. Os resultados mostram que os descritores de segurança AccessDenied foram removidos de todas as configurações de sessão.
Exemplo 5: impedir o acesso remoto às configurações de sessão que têm descritores de segurança personalizados
PS C:\> Register-PSSessionConfiguration -Name Test -FilePath .\TestEndpoint.pssc -ShowSecurityDescriptorUI
[ADMIN] PS C:\> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Wrap
Name Permission
---- ----------
microsoft.powershell BUILTIN\Administrators AccessAllowed
Test NT AUTHORITY\INTERACTIVE AccessAllowed, BUILTIN\Administrators AccessAllowed,
DOMAIN01\User01 AccessAllowed
[ADMIN] PS C:\> Disable-PSRemoting -Force
[ADMIN] PS C:\> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Wrap
Name Permission
---- ----------
microsoft.powershell NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
Test NT AUTHORITY\NETWORK AccessDenied, NTAUTHORITY\INTERACTIVE AccessAllowed,
BUILTIN\Administrators AccessAllowed, DOMAIN01\User01 AccessAllowed
# Domain01\User01
PS C:\> New-PSSession -ComputerName Server01 -ConfigurationName Test
[Server01] Connecting to remote server failed with the following error message : Access is denied. For more information, see the about_Rem
ote_Troubleshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailedEste exemplo demonstra que o cmdlet Disable-PSRemoting desabilita o acesso remoto a todas as configurações de sessão que incluem configurações de sessão com descritores de segurança personalizados.
O primeiro comando usa o cmdlet Register-PSSessionConfiguration para criar a configuração de sessão de teste. O comando usa o parâmetro FilePath para especificar um arquivo de configuração de sessão que personaliza a sessão e o parâmetro ShowSecurityDescriptorUI para exibir uma caixa de diálogo que define permissões para a configuração da sessão. Na caixa de diálogo Permissões, criamos permissões personalizadas de acesso completo para o usuário Domain01\User01.
O segundo comando usa os cmdlets Get-PSSessionConfiguration e Format-Table para exibir as configurações de sessão e suas propriedades. A saída mostra que a configuração da sessão de teste permite acesso interativo e permissões especiais para o usuário Domain01\User01.
O terceiro comando usa o cmdlet Disable-PSRemoting para desabilitar o acesso remoto a todas as configurações de sessão.
O quarto comando usa os cmdlets Get-PSSessionConfiguration e Format-Table para exibir as configurações de sessão e suas propriedades. A saída mostra que um descritor de segurança AccessDenied para todos os usuários de rede é adicionado a todas as configurações de sessão que incluem a configuração de sessão de teste. Embora os outros descritores de segurança não sejam alterados, o descritor de segurança "network_deny_all" tem precedência.
O quinto comando mostra que o comando Disable-PSRemoting impede que até mesmo o usuário domain01\User01 que tem permissões especiais para a configuração de sessão de teste use a configuração de sessão de teste para se conectar ao computador remotamente.
Exemplo 6: reabilitar o acesso remoto às configurações de sessão selecionadas
PS C:\> Disable-PSRemoting -Force
[ADMIN] PS C:\> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto
Name Permission
---- ----------
microsoft.powershell NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell.workflow NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell32 NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.ServerManager NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
WithProfile NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
[ADMIN] PS C:\> Set-PSSessionConfiguration -Name Microsoft.ServerManager -AccessMode Remote -Force
[ADMIN] PS C:\> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto
Name Permission
---- ----------
microsoft.powershell NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell.workflow NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell32 NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.ServerManager BUILTIN\Administrators AccessAllowed
WithProfile NT AUTHORITY\NETWORK AccessDenied, BUILTIN\Administrators AccessAllowedEste exemplo mostra como reabilitar o acesso remoto somente às configurações de sessão selecionadas.
O primeiro comando usa o cmdlet Disable-PSRemoting para desabilitar o acesso remoto a todas as configurações de sessão.
O segundo comando usa os cmdlets Get-PSSessionConfiguration e Format-Table para exibir as configurações de sessão e suas propriedades. A saída mostra que um descritor de segurança AccessDenied para todos os usuários de rede é adicionado a todas as configurações de sessão.
O terceiro comando usa o cmdlet Set-PSSessionConfiguration
O quarto comando usa os cmdlets Get-PSSessionConfiguration e Format-Table para exibir as configurações de sessão e suas propriedades. A saída mostra que o descritor de segurança AccessDenied para todos os usuários de rede foi removido, restaurando assim o acesso remoto à configuração da sessão Microsoft.ServerManager.
Parâmetros
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Não é possível redirecionar a entrada para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhum objeto.
Observações
Desabilitar as configurações de sessão não desfaz todas as alterações feitas pelos cmdlets
Enable-PSRemoting ouEnable-PSSessionConfiguration . Talvez seja necessário desfazer as alterações a seguir manualmente.
Pare e desabilite o serviço WinRM.
2. Exclua o ouvinte que aceita solicitações em qualquer endereço IP.
3. Desabilite as exceções de firewall para comunicações WS-Management.
4. Restaure o valor de LocalAccountTokenFilterPolicy para 0, o que restringe o acesso remoto aos membros do grupo Administradores no computador.
Uma configuração de sessão é um grupo de configurações que define o ambiente para uma sessão. Cada sessão que se conecta ao computador deve usar uma das configurações de sessão registradas no computador. Ao negar acesso remoto a todas as configurações de sessão, você efetivamente impede que usuários remotos estabeleçam sessões que se conectam ao computador.
No Windows PowerShell 2.0, Disable-PSRemoting adiciona uma entrada Deny_All aos descritores de segurança de todas as configurações de sessão. Essa configuração impede que todos os usuários criem sessões gerenciadas pelo usuário para o computador local. No Windows PowerShell 3.0, Disable-PSRemoting adiciona uma entrada Network_Deny_All aos descritores de segurança de todas as configurações de sessão. Essa configuração impede que os usuários em outros computadores criem sessões gerenciadas pelo usuário no computador local, mas permite que os usuários do computador local criem sessões de loopback gerenciadas pelo usuário.
No Windows PowerShell 2.0, Disable-PSRemoting é equivalente a Disable-PSSessionConfiguration -Name *.
No Windows PowerShell 3.0 e versões posteriores, Disable-PSRemoting é equivalente a Set-PSSessionConfiguration -Name \<Configuration name\> -AccessMode Local
No Windows PowerShell 2.0, Disable-PSRemoting é uma função. A partir do Windows PowerShell 3.0, ele é um cmdlet.