about_WSMan_Provider

  • Article

Nom du fournisseur

WSMan

Lecteurs

WSMan:

Description courte

Fournit l’accès aux informations de configuration des services web pour la gestion (WS-Management).

Description détaillée

Ces informations s’appliquent uniquement à PowerShell s’exécutant sur Windows.

Le fournisseur WSMan pour PowerShell vous permet d’ajouter, modifier, effacer et supprimer des données de configuration WS-Management sur des ordinateurs locaux ou distants.

Le fournisseur WSMan expose un lecteur PowerShell avec une structure de répertoires qui correspond à un regroupement logique des paramètres de configuration WS-Management. Ces regroupements sont appelés conteneurs.

À compter de Windows PowerShell 3.0, le fournisseur WSMan a été mis à jour pour prendre en charge de nouvelles propriétés pour les configurations de session, telles que OutputBufferingMode. Les configurations de session apparaissent en tant qu’éléments dans le répertoire plug-in du WSMan: lecteur et les propriétés apparaissent en tant qu’éléments dans chaque configuration de session.

Le fournisseur WSMan prend en charge les applets de commande suivantes, qui sont abordées dans cet article.

Remarque

Vous pouvez utiliser des commandes dans le WSMan: lecteur pour modifier les valeurs des nouvelles propriétés. Toutefois, vous ne pouvez pas utiliser le WSMan: lecteur dans PowerShell 2.0 pour modifier les propriétés introduites dans Windows PowerShell 3.0. Bien qu’aucune erreur ne soit générée, les commandes ne sont pas effectives Pour modifier ces paramètres, utilisez le lecteur WSMan dans Windows PowerShell 3.0.

Organisation du WSMan : Drive

  • Client : vous pouvez configurer différents aspects du client WS-Management. Les informations de configuration sont stockées dans le Registre.

  • Service : vous pouvez configurer différents aspects du service WS-Management. Les informations de configuration sont stockées dans le Registre.

    Remarque

    La configuration du service est parfois appelée configuration du serveur.

  • Shell : vous pouvez configurer différents aspects de l’interpréteur de commandes WS-Management, tels que le paramètre permettant d’autoriser l’accès à l’interpréteur de commandes à distance (AllowRemoteShellAccess) et le nombre maximal d’utilisateurs simultanés autorisés (MaxConcurrentUsers).

  • Écouteur : vous pouvez créer et configurer un écouteur. Un écouteur est un service de gestion qui implémente le protocole WS-Management pour envoyer et recevoir des messages.

  • Plug-in : les plug-ins sont chargés et utilisés par le service WS-Management pour fournir différentes fonctions. Par défaut, PowerShell fournit trois plug-ins :

    • Plug-in de transfert d’événements.
    • Plug-in Microsoft.PowerShell.
    • Plug-in WMI (Windows Management Instrumentation). Ces trois plug-ins prennent en charge le transfert d’événements, la configuration et l’accès WMI.

  • ClientCertificate : vous pouvez créer et configurer un certificat client. Un certificat client est utilisé lorsque le client WS-Management est configuré pour utiliser l’authentification par certificat.

Hiérarchie de répertoires du fournisseur WSMan

La hiérarchie de répertoires du fournisseur WSMan pour l’ordinateur local est la suivante.

WSMan:\localhost
--- Client
--- Service
--- Shell
--- Listener
------ <Specific_Listener>
--- Plugin
------ Event Forwarding Plugin
--------- InitializationParameters
--------- Resources
------------ Security
------ Microsoft.Powershell
--------- InitializationParameters
--------- Resources
------------ Security
------ WMI Provider
--------- InitializationParameters
--------- Resources
------------ Security
--- ClientCertificate

La hiérarchie de répertoires du fournisseur WSMan pour un ordinateur distant est identique à celle d’un ordinateur local. Toutefois, pour accéder aux paramètres de configuration d’un ordinateur distant, vous devez établir une connexion à l’ordinateur distant à l’aide de Connecter-WSMan. Une fois qu’une connexion est établie à un ordinateur distant, le nom de l’ordinateur distant s’affiche dans le fournisseur.

WSMan:\<Remote_Computer_Name>

Cette commande utilise l’applet de commande pour modifier l’emplacement Set-Location actuel du WSMan: lecteur.

Set-Location WSMan:

Pour revenir à un lecteur du système de fichiers, tapez le nom du lecteur. Par exemple, tapez.

Set-Location C:

Cette commande utilise la Set-Location commande pour remplacer l’emplacement actuel par l’emplacement racine de l’emplacement du magasin système distant. Utilisez une barre oblique inverse ou une barre oblique \/ pour indiquer un niveau du WSMan: lecteur.

Set-Location -Path  WSMan:\SERVER01

Remarque

La commande ci-dessus suppose qu’une connexion au système distant existe déjà.

Affichage du contenu du lecteur WSMan :

Cette commande utilise l’applet Get-Childitem de commande pour afficher les magasins WS-Management dans l’emplacement du magasin Localhost.

Get-ChildItem -path WSMan:\Localhost

Si vous êtes dans le WSMan: lecteur, vous pouvez omettre le nom du lecteur.

Cette commande utilise l’applet Get-Childitem de commande pour afficher les magasins WS-Management dans l’emplacement du magasin « SERVER01 » de l’ordinateur distant.

Get-ChildItem -path WSMan:\SERVER01

Remarque

La commande ci-dessus suppose qu’une connexion au système distant existe déjà.

Définition de la valeur des éléments dans le lecteur WSMAN :

Vous pouvez utiliser l’applet Set-Item de commande pour modifier les paramètres de configuration dans le WSMAN lecteur. L’exemple suivant définit la valeur TrustedHosts pour accepter tous les hôtes avec le suffixe « contoso.com ».

# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

L’applet Set-Item de commande prend en charge un paramètre -Concatenate supplémentaire qui ajoute une valeur au lieu de la modifier. L’exemple suivant ajoute une nouvelle valeur « *.domain2.com » à l’ancienne valeur stockée dans TrustedHost:

Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate

Création d’éléments dans le lecteur WSMAN :

Création d’un écouteur

L’applet New-Item de commande crée des éléments dans un lecteur de fournisseur. Chaque fournisseur a différents types d’éléments que vous pouvez créer. Dans le WSMAN: lecteur, vous pouvez créer des écouteurs que vous configurez pour recevoir et répondre aux demandes distantes . La commande suivante crée un écouteur HTTP à l’aide de l’applet de New-Item commande.

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

Création d’un plug-in

Cette commande crée (inscrit) un plug-in pour le service WS-Management.

New-Item -Path WSMan:\localhost\Plugin `
         -Plugin TestPlugin `
         -FileName %systemroot%\system32\WsmWmiPl.dll `
         -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema `
         -SDKVersion 1 `
         -Capability "Get","Put","Invoke","Enumerate" `
         -XMLRenderingType text

Création d’une entrée de ressource

Cette commande crée une entrée de ressource dans le répertoire Ressources d’un TestPlugin. Cette commande suppose qu’un TestPlugin a été créé à l’aide d’une commande distincte.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
         -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
         -Capability "Enumerate"

Création d’une entrée de sécurité pour une ressource

Cette commande crée une entrée de sécurité dans le répertoire sécurité de Resource_5967683 (ressource spécifique). Cette commande suppose que l’entrée de ressource a été créée à l’aide d’une commande distincte.

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
New-Item -Path $path\Security `
         -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"

Création d’un certificat client

Cette commande crée une entrée ClientCertificate qui peut être utilisée par le client WS-Management. Le nouveau ClientCertificate s’affiche sous le répertoire ClientCertificate en tant que « ClientCertificate_1234567890 ». Tous les paramètres sont obligatoires. L’émetteur doit être l’empreinte numérique du certificat des émetteurs.

$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
         -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
         -URI wmicimv2/* `
         -Credential $cred;

Création d’un paramètre d’initialisation

Cette commande crée un paramètre d’initialisation nommé « testparametername » dans le répertoire « InitializationParameters ». Cette commande suppose que le « TestPlugin » a été créé à l’aide d’une commande distincte.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
         -ParamName testparametername `
         -ParamValue testparametervalue

Paramètres dynamiques

Les paramètres dynamiques sont des paramètres d’applet de commande qui sont ajoutés par un fournisseur PowerShell et sont disponibles uniquement lorsque l’applet de commande est utilisée dans le lecteur avec le fournisseur.

Chaîne d’adresse <>

Spécifie l'adresse pour laquelle cet écouteur a été créé. Il peut s'agir de l'une des valeurs suivantes :

  • Chaîne littérale « * ». (Caractère générique carte (*) rend la commande lier toutes les adresses IP sur toutes les cartes réseau.)
  • Chaîne littérale « IP : » suivie d’une adresse IP valide au format IPv4 pointillé-décimal ou au format hexadécimal cloné IPv6.
  • Chaîne littérale « MAC : » suivie de l’adresse MAC d’un adaptateur. Par exemple : MAC :32-a3-58-90-be-cc.

Remarque

La valeur Address est définie lors de la création d’un écouteur.

Applets de commande prises en charge

Énumération de capacité <>

Lorsque vous utilisez des plug-ins , ce paramètre spécifie une opération prise en charge sur cet URI (Uniform Resource Identifier). Vous devez créer une entrée pour chaque type d’opération pris en charge par l’URI. Vous pouvez spécifier tous les attributs valides pour une opération donnée, si l’opération la prend en charge.

Ces attributs incluent SupportsFiltering et SupportsFragment.

  • Créer : les opérations de création sont prises en charge sur l’URI.
    • L’attribut SupportFragment est utilisé si l’opération Create prend en charge le concept.
    • L’attribut SupportFiltering n’est pas valide pour les opérations De création et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • Supprimer : les opérations de suppression sont prises en charge sur l’URI.
    • L’attribut SupportFragment est utilisé si l’opération Delete prend en charge le concept.
    • L’attribut SupportFiltering n’est pas valide pour les opérations Delete et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • Énumérer : Énumérer les opérations sont prises en charge sur l’URI.
    • L’attribut SupportFragment n’est PAS pris en charge pour les opérations d’énumération et doit être défini sur False.
    • L’attribut SupportFiltering est valide et si le plug-in prend en charge le filtrage, cet attribut doit être défini sur « True ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • Obtenir : les opérations Get sont prises en charge sur l’URI.
    • L’attribut SupportFragment est utilisé si l’opération Get prend en charge le concept.
    • L’attribut SupportFiltering n’est pas valide pour les opérations Get et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • Appel : les opérations d’appel sont prises en charge sur l’URI.
    • L’attribut SupportFragment n’est pas pris en charge pour les opérations Invoke et doit avoir la valeur False.
    • L’attribut SupportFiltering n’est pas valide et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • Put : les opérations put sont prises en charge sur l’URI.
    • L’attribut SupportFragment est utilisé si l’opération Put prend en charge le concept.
    • L’attribut SupportFiltering n’est pas valide pour les opérations Put et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • S’abonner : les opérations d’abonnement sont prises en charge sur l’URI.
    • L’attribut SupportFragment n’est pas pris en charge pour les opérations d’abonnement et doit avoir la valeur False.
    • L’attribut SupportFiltering n’est pas valide pour les opérations d’abonnement et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si les opérations Shell sont également prises en charge.

  • Shell : les opérations shell sont prises en charge sur l’URI.
    • L’attribut SupportFragment n’est pas pris en charge pour les opérations Shell et doit être défini sur « False ».
    • L’attribut SupportFiltering n’est pas valide pour les opérations Shell et doit être défini sur « False ».

    Remarque

    Cette opération n’est pas valide pour un URI si une autre opération est également prise en charge.

    Remarque

    Si une opération Shell est configurée pour un URI, Obtenir, Put, Créer, Supprimer, Appeler et Énumérer des opérations sont traitées en interne dans le service WS-Management (WinRM) pour gérer les interpréteurs de commandes. Par conséquent, le plug-in ne peut pas gérer les opérations.

Applets de commande prises en charge

CertificateThumbprint <String>

Spécifie l'empreinte numérique du certificat de service.

Cette valeur représente la chaîne de valeurs hexadécimales à deux chiffres dans le champ Empreinte numérique du certificat. Il spécifie le certificat de clé publique numérique (X509) d’un compte d’utilisateur autorisé à effectuer cette action. Les certificats sont utilisés dans l'authentification par certificat client. Ils ne peuvent être mappés qu’à des comptes d’utilisateur locaux et ne fonctionnent pas avec des comptes de domaine. Pour obtenir une empreinte numérique de certificat, utilisez les applets de commande ou Get-ChildItem les Get-Item applets de commande dans le lecteur PowerShellCert:.

Applets de commande prises en charge

Boolean activé <>

Spécifie si l'écouteur est activé ou désactivé. La valeur par défaut est True.

Applets de commande prises en charge

FileName (Plug-in) <String>

Spécifie le nom de fichier du plug-in d’opérations. Toutes les variables d’environnement qui sont placées dans cette entrée sont développées dans le contexte des utilisateurs lorsqu’une demande est reçue. Étant donné que chaque utilisateur peut avoir une version différente de la même variable d’environnement, chaque utilisateur peut avoir un plug-in différent. Cette entrée ne peut pas être vide et doit pointer vers un plug-in valide.

Applets de commande prises en charge

Chaîne HostName <>

Spécifie le nom d’hôte de l’ordinateur sur lequel le service WS-Management (WinRM) est en cours d’exécution.

La valeur doit être un nom de domaine complet, une chaîne littérale IPv4 ou IPv6, ou un caractère générique.

Applets de commande prises en charge

Chaîne de l’émetteur <>

Spécifie le nom de l’autorité de certification qui a émis le certificat.

Applets de commande prises en charge

Les <> plug-ins WS-Management sont des bibliothèques de liens dynamiques natives (DLL)

qui se plug-in pour étendre et étendre les fonctionnalités de WS-Management . L’API de plug-in WSW-Management fournit des fonctionnalités qui permettent à un utilisateur d’écrire des plug-ins en implémentant certaines API pour les URI et opérations de ressources pris en charge. Une fois les plug-ins configurés pour le service WS-Management (WinRM) ou pour les services Internet Information Services (IIS), les plug-ins sont chargés dans l’hôte WS-Management ou dans l’hôte IIS, respectivement. Les requêtes distantes sont acheminées vers ces points d’entrée de plug-in pour effectuer des opérations.

Applets de commande prises en charge

Entier court non signé de port <>

Spécifie le port TCP pour lequel cet écouteur est créé. Vous pouvez spécifier n’importe quelle valeur comprise entre 1 et 65535.

Applets de commande prises en charge

Chaîne de ressource <>

Spécifie un point de terminaison qui représente un type distinct d’opération de gestion ou de valeur. Un service expose une ou plusieurs ressources, et certaines ressources peuvent avoir plusieurs instances. Une ressource de gestion est similaire à une classe WMI ou à une table de base de données, et une instance est similaire à une instance de la classe ou à une ligne dans la table. Par exemple, la classe Win32_LogicalDisk représente une ressource. Win32_LogicalDisk="C:\\" est une instance spécifique de la ressource.

Un URI (Uniform Resource Identifier) contient un préfixe et un chemin d’accès à une ressource. Par exemple :

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Applets de commande prises en charge

Chaîne de ressource <>

Spécifie l’URI (Uniform Resource Identifier) qui identifie un type spécifique de ressource, tel qu’un disque ou un processus, sur un ordinateur.

Un URI se compose d'un préfixe et d'un chemin d'accès à une ressource. Par exemple :

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Applets de commande prises en charge

Chaîne SDKVersion <>

Spécifie la version du Kit de développement logiciel (SDK) du plug-in WS-Management. La seule valeur valide est 1.

Applets de commande prises en charge

Chaîne d’objet <>

Spécifie l’entité identifiée par le certificat.

Applets de commande prises en charge

Chaîne de transport <>

Spécifie le transport à utiliser pour envoyer et recevoir les demandes et les réponses du protocole WS-Management. La valeur doit être HTTP ou HTTPS.

Remarque : La valeur de transport est définie lors de la création d’un écouteur.

Applets de commande prises en charge

Chaîne d’URI <>

Identifie l’URI pour lequel l’accès est autorisé en fonction de la valeur du paramètre Sddl.

Applets de commande prises en charge

URLPrefix <String>

Préfixe d’URL sur lequel accepter les requêtes HTTP ou HTTPS. Il s’agit d’une chaîne contenant uniquement les caractères [a-z], , [9-0][A-Z]trait de soulignement (_) et barre oblique inverse (/). La chaîne ne doit pas commencer par ou se terminer par une barre oblique inverse (/). Par exemple, si le nom de l’ordinateur est « SampleComputer », le client WS-Management spécifie http://SampleMachine/URLPrefix dans l’adresse de destination.

Applets de commande prises en charge

Chaîne de valeur <>

Spécifie la valeur d’un paramètre d’initialisation, qui est une valeur spécifique au plug-in utilisée pour spécifier les options de configuration.

Applets de commande prises en charge

XMLRenderingType <, chaîne>

Spécifie le format dans lequel xml est passé aux plug-ins via l’objet WSMAN_DATA. Voici les valeurs valides :

  • Texte : les données XML entrantes sont contenues dans une structure WSMAN_DATA_TYPE_TEXT , qui représente le code XML en tant que mémoire tampon PCWSTR .
  • XMLReader : les données XML entrantes sont contenues dans une structure WSMAN_DATA_TYPE_WS_XML_READER , qui représente le code XML en tant qu’objet XmlReader , qui est défini dans le fichier d’en-tête « WebServices.h ».

Applets de commande prises en charge

Utilisation du pipeline

Les applets de commande du fournisseur acceptent l’entrée de pipeline. Vous pouvez utiliser le pipeline pour simplifier la tâche en envoyant des données de fournisseur d’une applet de commande à une autre applet de commande du fournisseur. Pour en savoir plus sur l’utilisation du pipeline avec des applets de commande de fournisseur, consultez les références d’applet de commande fournies dans cet article.

Obtenir de l'aide

Depuis Windows PowerShell 3.0, vous pouvez obtenir des rubriques d'aide personnalisées pour les applets de commande du fournisseur, qui expliquent comment ces applets de commande se comportent dans un lecteur du système de fichiers.

Pour obtenir les rubriques d’aide personnalisées pour le lecteur de système de fichiers, exécutez une commande Get-Help dans un lecteur de système de fichiers ou utilisez le -Path paramètre Get-Help pour spécifier un lecteur de système de fichiers.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Voir aussi