about_WS-Management_Cmdlets

Mis à jour: mai 2014

S'applique à: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

RUBRIQUE

about_WS-Management_Cmdlets

DESCRIPTION COURTE

Fournit une vue d'ensemble de WS-Management (Web Services for Management) comme base pour l'utilisation des applets de commande WS-Management dans Windows PowerShell®.

DESCRIPTION DÉTAILLÉE

Cette rubrique fournit une vue d'ensemble de WS-Management (Web Services for Management) comme base pour l'utilisation des applets de commande WS-Management dans Windows PowerShell. Cette rubrique fournit également des liens vers d'autres informations sur WS-Management. L'implémentation Microsoft de WS-Management est également appelée WinRM (Windows Remote Management).

À PROPOS DE WS-MANAGEMENT

WinRM est l'implémentation Microsoft du protocole WS-Management, un protocole standard basé sur SOAP et conforme aux pare-feu qui permet au matériel et aux systèmes d'exploitation de différents fournisseurs d'interagir. La spécification du protocole WS-Management offre un moyen commun aux systèmes d'accéder aux informations de gestion et de les échanger sur une infrastructure informatique. WS-Management et l'interface de gestion de plateforme intelligente (IPMI), ainsi que le Collecteur d'événements, sont des composants des fonctionnalités de gestion du matériel 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.

WS-MANAGEMENT ET WMI

WS-Management peut être utilisé pour récupérer les 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 de script WS-Management ou via l'outil en ligne de commande WinRM. WS-Management prend en charge la plupart des opérations et classes WMI classiques, 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 les ressources sur des ordinateurs Windows. Cela signifie que vous pouvez obtenir des données sur des objets, tels que des disques, cartes réseau, services ou processus dans votre entreprise via l'ensemble de classes WMI existant. Vous pouvez également accéder aux données matérielles qui sont disponibles à partir du fournisseur IPMI WMI standard.

FOURNISSEUR WINDOWS POWERSHELL WS-MANAGEMENT (WSMan)

Le fournisseur WSMan offre une vue hiérarchique dans les 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 WS-MANAGEMENT

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 sur les données. L'outil en ligne de commande WS-Management, WinRM et le transfert d'événements dépendent également de la configuration de 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 Management-Data

Get-WSManInstance :

Affiche les informations de gestion d'une instance de ressource spécifiée par un URI de ressource.

Invoke-WSManAction :

Appelle une action sur l'objet cible qui est 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 qui sont 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 distantes au service WS-Management (WinRM). L'applet de commande Set-WSManQuickConfig effectue les opérations suivantes :

- Elle 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.

Elle définit le type de démarrage automatique pour le service WS-Management (WinRM).

Elle crée un écouteur qui accepte les demandes à partir de n'importe quelle adresse IP. Le protocole de transport par défaut est HTTP.

Elle 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 les 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 vérifie 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 pour un ou plusieurs paramètres d'une applet de commande WS-Management.

Informations supplémentaires sur WS-Management

Pour plus d'informations sur WS-Management, consultez les rubriques suivantes dans MSDN (Microsoft Developer Network) Library.

« Windows Remote Management »

https://go.microsoft.com/fwlink/?LinkId=142321

« À propos de Windows Remote Management »

https://go.microsoft.com/fwlink/?LinkId=142322

« Installation et configuration de Windows Remote Management »

https://go.microsoft.com/fwlink/?LinkId=142323

« Architecture Windows Remote Management »

https://go.microsoft.com/fwlink/?LinkId=142324

« Protocole WS-Management »

https://go.microsoft.com/fwlink/?LinkId=142325

« Windows Remote Management et WMI »

https://go.microsoft.com/fwlink/?LinkId=142326

« URI de ressource »

https://go.microsoft.com/fwlink/?LinkId=142327

« Gestion du matériel à distance »

https://go.microsoft.com/fwlink/?LinkId=142328

« Événements »

https://go.microsoft.com/fwlink/?LinkId=142329

VOIR AUSSI

Version en ligne : https://go.microsoft.com/fwlink/?LinkId=142331

Connect-WSMan

Disable-WSManCredSSP

Disconnect-WSMan

Enable-WSManCredSSP

Get-WSManCredSSP

Get-WSManInstance

Invoke-WSManAction

New-WSManInstance

Remove-WSManInstance

Set-WSManInstance

Set-WSManQuickConfig

Set-WSManSessionOption

Test-WSMan

MOTS CLÉS

about_WSMAN about_WinRM