Share via

Disable-PSSessionConfiguration

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

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

Syntax

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

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Disable-PSSessionConfiguration de commande 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 des configurations de sessions personnalisées pour leurs utilisateurs.

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

Dans PowerShell 2.0, l’applet Disable-PSSessionConfiguration de commande ajoute une entrée Deny_All au descripteur de sécurité d’une ou de 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. À moins que l'utilisateur ne spécifie une autre configuration, 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 montre comment désactiver la configuration de session Microsoft.PowerShell .

Disable-PSSessionConfiguration

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

Cet exemple montre comment désactiver toutes les configurations de session inscrites sur l’ordinateur.

Disable-PSSessionConfiguration -Name *

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

Cet exemple montre comment désactiver toutes les configurations de session dont le nom commence par Microsoft. Le paramètre Force supprime toutes les invites de l’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 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

Notes

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

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Force

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

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

-Name

Spécifie un tableau de noms de configurations de session à désactiver. Entrez un ou plusieurs noms de configurations. Les caractères génériques sont autorisés. Vous pouvez également diriger une chaîne qui contient 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Permet d’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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 pas d'objets.

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.

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