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