Partilhar via

Disable-PSSessionConfiguration

Módulo:
Microsoft.PowerShell.Core Module

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

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet Disable-PSSessionConfiguration 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 cmdlet Disable-PSSessionConfiguration define a configuração Enabled da configuração de sessão (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) como False.

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

Sem parâmetros, 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 o MaintenanceShell e AdminShell configurações de sessão. O operador do gasoduto (|) envia os resultados de um 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 de executar 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

Observação

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

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

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

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

Se você omitir esse parâmetro, Disable-PSSessionConfiguration desabilitará a configuração de sessão do Microsoft.PowerShell.

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

Usado para impedir a reinicialização do serviço WSMan. Não é necessário reiniciar o serviço para desativar a configuraçã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

-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 ou uma cadeia de caracteres que contenha o nome de uma configuração de sessão para esse cmdlet.

Saídas

None

Este cmdlet não retorna nenhum objeto.

Notas

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