Partager via

Disable-PSSessionConfiguration

  • Référence
Module:
Microsoft.PowerShell.Core

Désactive les configurations de session sur l’ordinateur local.

Syntaxe

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

Description

L’applet de commande Disable-PSSessionConfiguration désactive les configurations de session sur l’ordinateur local, ce qui empêche tous les utilisateurs d’utiliser les configurations de session pour créer des sessions gérées par l’utilisateur (PSSessions) sur l’ordinateur local. Il s’agit d’une applet de commande avancée conçue pour être utilisée par les administrateurs système pour gérer les configurations de session personnalisées pour leurs utilisateurs.

À compter de PowerShell 3.0, l’applet de commande Disable-PSSessionConfiguration définit le paramètre Activé de la configuration de session (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) sur False.

Dans PowerShell 2.0, l’applet de commande Disable-PSSessionConfiguration ajoute une entrée Deny_All au descripteur de sécurité d’une ou plusieurs configurations de session inscrites.

Sans paramètres, Disable-PSSessionConfiguration désactive la configuration Microsoft.PowerShell, la configuration par défaut utilisée pour les sessions. Sauf si l’utilisateur spécifie une configuration différente, les utilisateurs locaux et distants ne peuvent pas créer de sessions qui se connectent à l’ordinateur.

Pour désactiver toutes les configurations de session sur l’ordinateur, utilisez Disable-PSRemoting.

Exemples

Exemple 1 : Désactiver la configuration par défaut

Cet exemple désactive la configuration de session Microsoft.PowerShell.

Disable-PSSessionConfiguration

Exemple 2 : Désactiver toutes les configurations de session inscrites

Cet exemple désactive toutes les configurations de session inscrites sur l’ordinateur.

Disable-PSSessionConfiguration -Name *

Exemple 3 : Désactiver les configurations de session par nom

Cet exemple désactive toutes les configurations de session qui ont des noms qui commencent par Microsoft. Le paramètre Forcer supprime toutes les invites utilisateur de l’applet de commande.

Disable-PSSessionConfiguration -Name Microsoft* -Force

Exemple 4 : Désactiver les configurations de session à l’aide du pipeline

Cet exemple montre comment désactiver les configurations de session MaintenanceShell et AdminShell. L’opérateur de pipeline (|) envoie les résultats d’un Get-PSSessionConfiguration à Disable-PSSessionConfiguration.

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

Exemple 5 : Effets de la désactivation d’une configuration de session

Cet exemple montre les autorisations avant et après l’exécution de Disable-PSSessionConfiguration et l’effet de la désactivation d’une configuration de session.

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

Note

La désactivation de la configuration n’empêche pas de modifier la configuration à l’aide de l’applet de commande Set-PSSessionConfiguration. Elle empêche uniquement l’utilisation de la configuration.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un tableau de noms de configurations de session à désactiver. Entrez un ou plusieurs noms de configuration. Les caractères génériques sont autorisés. Vous pouvez également diriger une chaîne contenant un nom de configuration ou un objet de configuration de session vers Disable-PSSessionConfiguration.

Si vous omettez ce paramètre, Disable-PSSessionConfiguration désactive la configuration de session Microsoft.PowerShell.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-NoServiceRestart

Utilisé pour empêcher le redémarrage du service WSMan. Il n’est pas nécessaire de redémarrer le service pour désactiver la configuration.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Vous pouvez diriger un objet de configuration de session ou une chaîne qui contient le nom d’une configuration de session vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucun objet.

Notes

Pour exécuter cette applet de commande, vous devez démarrer PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.