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 Activé 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 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 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 Force 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 désactive les configurations de session MaintenanceShell et Administration Shell. 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

Remarque

La désactivation de la configuration n’empêche pas de modifier la configuration à l’aide de l’applet Set-PSSessionConfiguration de 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 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
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 vers cette applet de commande.

String

Vous pouvez diriger 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 de sortie.

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 .