Partager via

Set-WSManQuickConfig

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

Configure l'ordinateur local pour la gestion à distance.

Syntax

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 les commandes à distance PowerShell envoyées à l’aide de la technologie Web Services for Management (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

Notes

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
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, Enable-PSRemoting la réactive, 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 de Set-NetFirewallRule commande dans le module NetSecurity .

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 de HTTPS au lieu de HTTP. Si vous utilisez ce paramètre et que SSL n’est pas disponible sur le port utilisé pour la connexion, la commande échoue.

HTTPS nécessite une configuration manuelle de WinRM et des règles de pare-feu. Pour plus d’informations, consultez Guide pratique pour configurer WINRM pour HTTPS.

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

Entrées

None

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

Sorties

String

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