Disable-PSSessionConfiguration

  • Referência
Módulo:
Microsoft.PowerShell.Core

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

Syntax

Disable-PSSessionConfiguration
       [[-Name] <String[]>]
       [-Force]
       [-NoServiceRestart]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

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

O Disable-PSSessionConfiguration cmdlet desabilita as configurações de sessão no computador local, o que impede que todos os usuários usem as configurações de sessão para criar sessões gerenciadas pelo usuário (PSSessions) no computador local. 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.

A partir do PowerShell 3.0, o Disable-PSSessionConfiguration cmdlet define a configuração Enabled da configuração de sessão (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) como False.

No PowerShell 2.0, o Disable-PSSessionConfiguration cmdlet adiciona uma entrada Deny_All ao descritor de segurança de uma ou mais configurações de sessão registradas.

Sem parâmetros, Disable-PSSessionConfiguration desabilita a configuração Microsoft.PowerShell, a configuração padrão usada para sessões. A menos que o usuário especifique uma configuração diferente, os usuários locais e remotos são efetivamente impedidos de criar quaisquer sessões que se conectem ao computador.

Para desativar todas as configurações de sessão no computador, use Disable-PSRemoting.

Exemplos

Exemplo 1: Desativar a configuração padrão

Este exemplo desabilita a configuração de sessão do Microsoft.PowerShell .

Disable-PSSessionConfiguration

Exemplo 2: Desativar todas as configurações de sessão registada

Este exemplo desabilita todas as configurações de sessão registradas no computador.

Disable-PSSessionConfiguration -Name *

Exemplo 3: Desativar configurações de sessão por nome

Este exemplo desabilita todas as configurações de sessão com nomes que começam com Microsoft. O parâmetro Force suprime todos os prompts do usuário do cmdlet.

Disable-PSSessionConfiguration -Name Microsoft* -Force

Exemplo 4: Desabilitar configurações de sessão usando o pipeline

Este exemplo desabilita as configurações de sessão MaintenanceShell e AdminShell . O operador do gasoduto (|) envia os resultados de a Get-PSSessionConfiguration para Disable-PSSessionConfiguration.

Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

Exemplo 5: Efeitos da desativação de uma configuração de sessão

Este exemplo mostra as permissões antes e depois da execução Disable-PSSessionConfiguration e o efeito de desabilitar uma configuração de sessão.

PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell

[localhost] 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 : PSSessionOpenFailed

Nota

A desativação da configuração não impede que você altere a configuração usando o Set-PSSessionConfiguration cmdlet. Apenas impede a utilização da configuração.

Parâmetros

-Confirm

Solicita a 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

Força o comando a ser executado sem pedir a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica uma matriz de nomes de configurações de sessão a serem desabilitadas. 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 .Disable-PSSessionConfiguration

Se você omitir esse parâmetro, Disable-PSSessionConfiguration desabilitará 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

Usado para impedir a reinicialização do serviço WSMan. Não é necessário reiniciar o serviço para desativar a configuração.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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 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

Este cmdlet só está disponível em plataformas Windows.

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