Enable-PSSessionConfiguration
Active les configurations de session sur l’ordinateur local.
Syntaxe
Default (Par défaut)
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Enable-PSSessionConfiguration active les configurations de session inscrites qui ont été désactivées, telles que l’utilisation des applets de commande Disable-PSSessionConfiguration ou Disable-PSRemoting, ou le paramètre AccessMode de Register-PSSessionConfiguration. 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.
Sans paramètres, Enable-PSSessionConfiguration active la configuration Microsoft.PowerShell, qui est la configuration par défaut utilisée pour les sessions.
Enable-PSSessionConfiguration supprime le paramètre Deny_All du descripteur de sécurité des configurations de session concernées, active l’écouteur qui accepte les demandes sur n’importe quelle adresse IP et redémarre le service WinRM. À compter de PowerShell 3.0, Enable-PSSessionConfiguration définit également la valeur de la propriété Enabled de la configuration de session (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) sur True. Toutefois, Enable-PSSessionConfiguration ne supprime pas ou ne modifie pas le paramètre de descripteur de sécurité Network_Deny_All (AccessMode=Local) qui permet uniquement aux utilisateurs de l’ordinateur local d’utiliser la configuration de session.
Exemples
Exemple 1 : réactiver la session par défaut
Cet exemple montre comment réactiver la configuration de session par défaut Microsoft.PowerShell sur l’ordinateur.
Enable-PSSessionConfiguration
Exemple 2 : réactiver les sessions spécifiées
Cet exemple montre comment réactiver les configurations de session MaintenanceShell et AdminShell sur l’ordinateur.
Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell
Exemple 3 : réactiver toutes les sessions
Cet exemple montre comment réactiver toutes les configurations de session sur l’ordinateur. Ces commandes sont équivalentes. Par conséquent, vous pouvez utiliser l’une ou l’autre.
Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration
Enable-PSSessionConfiguration ne génère pas d’erreur si vous activez une configuration de session déjà activée.
Exemple 4 : réactiver une session et spécifier un nouveau descripteur de sécurité
Cet exemple montre comment réactiver la configuration de session MaintenanceShell et spécifie un nouveau descripteur de sécurité pour la configuration.
$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl
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
Indique que l’applet de commande ne vous invite pas à confirmer et redémarre le service WinRM sans vous inviter. Le redémarrage du service rend la modification de configuration effective.
Pour empêcher un redémarrage et supprimer l’invite de redémarrage, utilisez le paramètre NoServiceRestart.
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 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.
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
Indique que l’applet de commande ne redémarre pas le service.
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 |
-SecurityDescriptorSddl
Spécifie un descripteur de sécurité avec lequel cette applet de commande remplace le descripteur de sécurité dans la configuration de session.
Si vous omettez ce paramètre, Enable-PSSessionConfiguration supprime uniquement l’élément refuser tout élément du descripteur de sécurité.
Propriétés du paramètre
| Type: | String |
| 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 |
-SkipNetworkProfileCheck
Indique que cette applet de commande active la configuration de session lorsque l’ordinateur se trouve sur un réseau public. Ce paramètre active une règle de pare-feu pour les réseaux publics qui autorise l’accès à distance uniquement à partir d’ordinateurs du même sous-réseau local. Par défaut, Enable-PSSessionConfiguration échoue sur un réseau public.
Ce paramètre est conçu pour les versions clientes du système d’exploitation Windows. Les versions serveur du système d’exploitation Windows ont une règle de pare-feu de sous-réseau local pour les réseaux publics. Toutefois, si la règle de pare-feu de sous-réseau local est désactivée sur une version serveur du système d’exploitation Windows, ce paramètre le réactive.
Pour supprimer la restriction de sous-réseau local et activer l’accès à distance à partir de tous les emplacements sur les réseaux publics, utilisez l’applet de commande Set-NetFirewallRule dans le module NetSecurity. Pour plus d’informations, consultez Enable-PSRemoting.
Ce paramètre a été introduit dans PowerShell 3.0.
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 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 aucun objet.
Notes
Pour utiliser cette applet de commande, vous devez démarrer PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.
Liens associés
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- Fournisseur WSMan
- à_propos_des_Configurations_de_Session
- à_propos_des_fichiers_de_configuration_de_session