Partager via

Disable-PSSessionConfiguration

Module:
Microsoft.PowerShell.Core Module

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

Syntaxe

Default (Par défaut) 

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

Description

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

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 commençant 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’une 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

Remarque

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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 aucune 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.