about_WS-Management_Cmdlets

Article
11/06/2024

DESCRIPTION COURTE

Fournit une vue d’ensemble des services Web pour la gestion (WS-Management) en arrière-plan pour l’utilisation des applets de commande WS-Management dans Windows PowerShell.

DESCRIPTION DÉTAILLÉE

Cette rubrique fournit une vue d’ensemble des services Web pour la gestion (WS-Management) en arrière-plan pour l’utilisation des applets de commande WS-Management dans Windows PowerShell. Cette rubrique fournit également des liens vers des informations supplémentaires sur WS-Management. L’implémentation Microsoft de WS-Management est également appelée Windows Remote Management (WinRM).

À propos de WS-Management

La gestion à distance De Windows est l’implémentation Microsoft du protocole WS-Management, un protocole standard basé sur SOAP, convivial pour le pare-feu, qui permet aux systèmes d’exploitation et matériels de différents fournisseurs d’interagir. La spécification du protocole WS-Management fournit un moyen commun pour les systèmes d’accéder aux informations de gestion et d’échanger des informations de gestion sur une infrastructure informatique ( information technology). WS-Management et Intelligent Platform Management Interface (IPMI), ainsi que le collecteur d’événements, sont des composants des fonctionnalités de gestion matérielle Windows.

Le protocole WS-Management est basé sur les spécifications de service web standard suivantes : HTTPS, SOAP sur HTTP (profil WS-I), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration et WS-Eventing.

Gestion WS et WMI

WS-Management peut être utilisé pour récupérer des données exposées par WMI (Windows Management Instrumentation). Vous pouvez obtenir des données WMI avec des scripts ou des applications qui utilisent l’API scripting WS-Management ou via l’outil en ligne de commande WinRM. WS-Management prend en charge la plupart des classes et opérations WMI familières, y compris les objets incorporés. WS-Management peut tirer parti de WMI pour collecter des données sur les ressources ou pour gérer des ressources sur des ordinateurs Windows. Cela signifie que vous pouvez obtenir des données sur des objets tels que des disques, des cartes réseau, des services ou des processus dans votre entreprise via l’ensemble existant de classes WMI. Vous pouvez également accéder aux données matérielles disponibles à partir du fournisseur IPMI WMI standard.

Fournisseur Windows PowerShell de gestion WS (WSMan)

Le fournisseur WSMan fournit une vue hiérarchique des paramètres de configuration WS-Management disponibles. Le fournisseur vous permet d’explorer et de définir les différentes options de configuration WS-Management.

Configuration de la gestion WS

Si WS-Management n’est pas installé et configuré, la communication à distance Windows PowerShell n’est pas disponible, les applets de commande WS-Management ne s’exécutent pas, les scripts WS-Management ne s’exécutent pas et le fournisseur WSMan ne peut pas effectuer d’opérations de données. L’outil en ligne de commande WS-Management, WinRM et le transfert d’événements dépendent également de la configuration WS-Management.

Applets de commande WS-Management

La fonctionnalité WS-Management est implémentée dans Windows PowerShell via un module qui contient un ensemble d’applets de commande et le fournisseur WSMan. Vous pouvez utiliser ces applets de commande pour effectuer les tâches de bout en bout nécessaires pour gérer les paramètres WS-Management sur les ordinateurs locaux et distants.

Les applets de commande WS-Management suivantes sont disponibles.

Applets de commande de connexion

Connect-WSMan : connecte l’ordinateur local au service WS-Management (WinRM) sur un ordinateur distant.
Disconnect-WSMan : déconnecte l’ordinateur local du service WS-Management (WinRM) sur un ordinateur distant.

Applets de commande gestion-données

Get-WSManInstance : affiche des informations de gestion pour une instance de ressource spécifiée par un URI de ressource.
Invoke-WSManAction : appelle une action sur l’objet cible spécifié par l’URI de ressource et par les sélecteurs.
New-WSManInstance : crée une instance de ressource de gestion.
Remove-WSManInstance : supprime une instance de ressource de gestion.
Set-WSManInstance : modifie les informations de gestion associées à une ressource.

Applets de commande d’installation et de configuration

Set-WSManQuickConfig : configure l’ordinateur local pour la gestion à distance. Vous pouvez utiliser l’applet de commande Set-WSManQuickConfig pour configurer WS-Management pour autoriser les connexions à distance au service WS-Management (WinRM). L’applet de commande Set-WSManQuickConfig effectue les opérations suivantes :
- Il détermine si le service WS-Management (WinRM) est en cours d’exécution. Si le service WinRM n’est pas en cours d’exécution, l’applet de commande Set-WSManQuickConfig démarre le service.
- Il définit le type de démarrage du service WS-Management (WinRM) sur automatique.
- Il crée un écouteur qui accepte les demandes de n’importe quelle adresse IP. Le protocole de transport par défaut est HTTP.
- Il active une exception de pare-feu pour le trafic WS-Management.
Remarque : Pour exécuter cette applet de commande dans Windows Vista, Windows Server 2008 et versions ultérieures de Windows, vous devez démarrer Windows PowerShell avec l’option « Exécuter en tant qu’administrateur ».
Test-WSMan : vérifie que WS-Management est installé et configuré. L’applet de commande Test-WSMan teste si le service WS-Management (WinRM) est en cours d’exécution et configuré sur un ordinateur local ou distant.
Disable-WSManCredSSP : désactive l’authentification CredSSP sur un ordinateur client.
Enable-WSManCredSSP : active l’authentification CredSSP sur un ordinateur client.
Get-WSManCredSSP : obtient la configuration liée à CredSSP pour un ordinateur client.

Applets de commande spécifiques à WS Management

New-WSManSessionOption : crée un objet WSManSessionOption à utiliser comme entrée dans un ou plusieurs paramètres d’une applet de commande WS-Management.