Enable-PSSessionConfiguration

Article
01/13/2010

Active les configurations de session sur l'ordinateur local.

Syntaxe

Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirmer] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Enable-PSSessionConfiguration réactive les configurations de session inscrites qui ont été désactivées à l'aide de l'applet de commande Disable-PSSessionConfiguration. Il s'agit d'une applet de commande avancée, conçue pour être employée par les administrateurs système pour la gestion des configurations de session personnalisées des utilisateurs.

Sans paramètres, Enable-PSSessionConfiguration réactive la configuration Microsoft.PowerShell, qui est la configuration par défaut utilisée pour les sessions.

Cette applet de commande exécute les opérations suivantes pour chaque configuration activée :

-- Supprime le paramètre « Tout refuser » du descripteur de sécurité de la configuration ou remplace le descripteur de sécurité par celui que vous spécifiez.

--Active l'écouteur qui accepte les demandes sur toute adresse IP.

-- Redémarre le service WinRM.

L'applet de commande Enable-PSSessionConfiguration appelle l'applet de commande Set-WSManQuickConfig. Toutefois, elle ne doit pas être utilisée pour activer la communication à distance sur l'ordinateur. Faites plutôt appel à l'applet de commande plus complète Enable-PSRemoting.

Paramètres

-Force

Supprime toutes les invites utilisateur et redémarre le service WinRM sans demander de confirmation. Pour que la modification de la configuration prenne effet, le service doit être redémarré.

Pour empêcher un redémarrage et supprimer l'invite proposant cette opération, utilisez le paramètre NoServiceRestart.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Name <string[]>

Spécifie les noms des configurations de session à activer. 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 Enable-PSSessionConfiguration.

Si vous omettez ce paramètre, Enable-PSSessionConfiguration active la configuration de session Microsoft.PowerShell.

Obligatoire ?	false
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue, ByPropertyName)
Accepter les caractères génériques ?	true

-SecurityDescriptorSDDL <string>

Remplace le descripteur de sécurité de la configuration de session par celui spécifié.

Si vous omettez ce paramètre, Enable-PSSessionConfiguration supprime uniquement l'élément « Tout refuser » du descripteur de sécurité.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Confirmer

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String

Vous pouvez diriger un objet de configuration de session ou une chaîne contenant le nom d'une configuration de session vers Enable-PSSessionConfiguration.

Sorties

Aucun

Cette applet de commande ne retourne pas d'objets.

Remarques

Pour exécuter cette applet de commande sur Windows Vista, Windows Server 2008 et les versions ultérieures de Windows, vous devez démarrer Windows PowerShell avec l'option Exécuter en tant qu'administrateur.

Exemple 1

C:\PS>Enable-PSSessionConfiguration

Description
-----------
Cette commande réactive la configuration de session par défaut Microsoft.PowerShell sur l'ordinateur.

Exemple 2

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell

Description
-----------
Cette commande réactive les configurations de session MaintenanceShell et AdminShell sur l'ordinateur.

Exemple 3

C:\PS>Enable-PSSessionConfiguration -name *

C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Description
-----------
Ces commandes réactivent toutes les configurations de session sur l'ordinateur. Étant donné qu'elles sont équivalentes, vous pouvez utiliser l'une ou l'autre indifféremment.

Enable-PSSessionConfiguration ne génère pas d'erreur si vous activez une configuration de session qui est déjà activée.

Exemple 4

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"

Description
-----------
Cette commande réactive la configuration de session MaintenanceShell et spécifie un nouveau descripteur de sécurité pour la configuration.

Voir aussi

Concepts

about_Session_Configurations
Disable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider

Partager via