Enable-PSSessionConfiguration
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