Enable-PSSessionConfiguration

  • Référence
Module:
Microsoft.PowerShell.Core

Active les configurations de session sur l'ordinateur local.

Syntax

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

L’applet Enable-PSSessionConfiguration de commande active les configurations de session inscrites qui ont été désactivées, telles que l’utilisation des Disable-PSSessionConfiguration applets de commande ou Disable-PSRemoting 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 des configurations de sessions 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 De 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 Administration Shell 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écifier 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 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

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 permet d'appliquer la modification de configuration.

Pour empêcher un redémarrage et supprimer l’invite de redémarrage, utilisez le paramètre NoServiceRestart .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Indique que l’applet de commande ne redémarre pas le service.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 le refus de tout élément du descripteur de sécurité.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Celle-ci n'autorise l'accès à distance qu'à 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 Set-NetFirewallRule de commande dans le module NetSecurity. Pour plus d’informations, consultez Enable-PSRemoting.

Ce paramètre a été introduit dans PowerShell 3.0.

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 utiliser cette applet de commande, vous devez démarrer PowerShell à l’aide de l’option Exécuter en tant qu’administrateur .