Partager via

Set-WSManQuickConfig

  • Référence
Module:
Microsoft.WSMan.Management

Configure l'ordinateur local pour la gestion à distance.

Syntaxe

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

Description

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

L’applet Set-WSManQuickConfig de commande configure l’ordinateur pour recevoir des commandes à distance PowerShell envoyées à l’aide de la technologie de gestion des services web (WS-Management).

Set-WSManQuickConfig effectue les actions suivantes :

  • Vérifie si le service WinRM est en cours d’exécution. Si le service WinRM n’est pas en cours d’exécution, le service est démarré.
  • Définit le type de démarrage du service WinRM sur Automatique.
  • Crée un écouteur pour accepter les demandes sur n’importe quelle adresse IP. Le transport par défaut est HTTP.
  • Active une exception de pare-feu pour le trafic WinRM.

Pour exécuter Set-WSManQuickConfig, démarrez PowerShell avec l’option Exécuter en tant qu’administrateur .

Exemples

Exemple 1 : Activer la gestion à distance de l’ordinateur local via HTTP

Cet exemple montre comment définir la configuration requise pour activer la gestion à distance de l’ordinateur local. Par défaut, cette commande crée un écouteur WS-Management sur HTTP.

Set-WSManQuickConfig

Exemple 2 : Activer la gestion à distance de l’ordinateur local via HTTPS

Cet exemple montre comment définir la configuration requise pour activer la gestion à distance de l’ordinateur local. Le paramètre UseSSL spécifie que HTTPS est utilisé pour communiquer avec l’ordinateur.

Set-WSManQuickConfig -UseSSL

Remarque

HTTPS nécessite une configuration manuelle. Pour plus d’informations, consultez la description du paramètre UseSSL .

Paramètres

-Force

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkipNetworkProfileCheck

Configure les versions du client Windows pour la communication à distance 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.

Ce paramètre n’a aucun effet sur les versions de serveur de Windows, qui, par défaut, ont une règle de pare-feu de sous-réseau local pour les réseaux publics. Si la règle de pare-feu de sous-réseau local est désactivée sur la version serveur de Windows, la réactive, Enable-PSRemoting quelle que soit la valeur de ce paramètre.

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 .

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

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseSSL

Spécifie que le protocole SSL (Secure Sockets Layer) est utilisé pour établir une connexion à l’ordinateur distant. Par défaut, SSL n’est pas utilisé.

WS-Management chiffre tout le contenu PowerShell transmis sur le réseau. Le paramètre UseSSL vous permet de spécifier la protection supplémentaire du protocole HTTPS au lieu de HTTP. Si vous utilisez ce paramètre et SSL n’est pas disponible sur le port utilisé pour la connexion, la commande échoue.

HTTPS nécessite une configuration manuelle des règles winRM et de pare-feu. Pour plus d’informations, consultez How To : Configure WINRM for HTTPS.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

String

Cette applet de commande retourne un message sous forme d’objet String décrivant l’état de la configuration après l’opération.