NOM
Measure-Command
RÉSUMÉ
Mesure le temps qu'il faut pour exécuter des blocs de script et des applets de commande.
SYNTAXE
Measure-Command [-Expression] <scriptblock> [-InputObject <psobject>] [<CommonParameters>]
DESCRIPTION
L'applet de commande Measure-Command exécute en interne un bloc de script ou une applet de commande, chronomètre l'exécution de l'opération et retourne le temps d'exécution.
PARAMÈTRES
-Expression <scriptblock>
Spécifie l'expression qui est chronométrée. Mettez l'expression entre accolades ({}). Le nom du paramètre (« Expression ») est facultatif.
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <psobject>
Spécifie les objets représentant les expressions à mesurer. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
System.Management.Automation.PSObject
Vous pouvez diriger un objet vers Measure-Command.
SORTIES
System.TimeSpan
Measure-Command retourne un objet de durée qui représente le résultat.
NOTES
Pour plus d'informations, tapez « Get-Help Measure-Command -detailed ». Pour obtenir des informations techniques, tapez « Get-Help Measure-Command -full ».
Lors de la spécification de plusieurs valeurs pour un même paramètre, utilisez des virgules pour séparer les valeurs. Par exemple, « <nom_paramètre> <valeur1>, <valeur2> ».
-------------------------- EXEMPLE 1 --------------------------
C:\PS>Measure-Command { get-eventlog "windows powershell" }
Description
-----------
Cette commande mesure le temps requis pour exécuter une commande « get-eventlog » permettant d'obtenir les événements du journal des événements Windows PowerShell.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>measure-command {get-childitem c:\windows -include *.txt -recurse}
Days : 0
Hours : 0
Minutes : 0
Seconds : 8
Milliseconds : 618
Ticks : 86182763
TotalDays : 9.9748568287037E-05
TotalHours : 0.00239396563888889
TotalMinutes : 0.143637938333333
TotalSeconds : 8.6182763
TotalMilliseconds : 8618.2763
C:\PS>measure-command {get-childitem c:\windows -filter "*.txt" -recurse}
Days : 0
Hours : 0
Minutes : 0
Seconds : 1
Milliseconds : 140
Ticks : 11409189
TotalDays : 1.32050798611111E-05
TotalHours : 0.000316921916666667
TotalMinutes : 0.019015315
TotalSeconds : 1.1409189
TotalMilliseconds : 1140.9189
Description
-----------
Ces commandes affichent la valeur d'utilisation d'un filtre spécifique au fournisseur dans les commandes Windows PowerShell. La première commande mesure le temps requis pour traiter une commande Get-ChildItem récursive qui utilise le paramètre Include. La deuxième commande mesure le temps requis pour traiter une commande Get-ChildItem récursive qui utilise le paramètre Filter spécifique au fournisseur.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113348
Trace-Command
Invoke-Command
jeudi 21 février 2013
Limit-EventLog
NOM
Limit-EventLog
RÉSUMÉ
Définit les propriétés de journal des événements qui limitent la taille du journal des événements et l'ancienneté de ses entrées.
SYNTAXE
Limit-EventLog [-LogName] <string[]> [-ComputerName <string[]>] [-MaximumSize <Int64>] [-OverFlowAction {OverwriteAsNeeded | OverwriteOlder | DoNotOverwrite}] [-RetentionDays <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
L'applet de commande Limit-EventLog définit la taille maximale d'un journal des événements classique, la durée de conservation de chaque événement et l'action prévue lorsque le journal atteint sa taille maximale. Vous pouvez l'utiliser pour limiter les journaux des événements sur les ordinateurs locaux ou distants.
Les applets de commande contenant le nom EventLog (les applets de commande EventLog) fonctionnent uniquement sur les journaux des événements classiques. Pour obtenir des événements à partir des journaux qui utilisent la technologie Journal des événements Windows sous Windows Vista et les versions ultérieures de Windows, utilisez Get-WinEvent.
PARAMÈTRES
-ComputerName <string[]>
Spécifie un ordinateur distant. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou le nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) ou « localhost ».
Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Limit-EventLog même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.
Obligatoire ? false
Position ? named
Valeur par défaut Ordinateur local
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-LogName <string[]>
Spécifie les journaux des événements. Entrez le nom de journal (la valeur de la propriété Log et non LogDisplayName) d'un ou de plusieurs journaux des événements, en les séparant par des virgules. Les caractères génériques ne sont pas autorisés. Ce paramètre est obligatoire.
Obligatoire ? true
Position ? 1
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-MaximumSize <Int64>
Spécifie la taille maximale des journaux des événements (en octets). Entrez une valeur comprise entre 64 kilo-octets (Ko) et 4 gigaoctets (Go). La valeur doit être divisible par 64 Ko (65 536).
Ce paramètre spécifie la valeur de la propriété MaximumKilobytes de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
Obligatoire ? false
Position ? named
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-OverFlowAction <OverflowAction>
Spécifie l'action prévue lorsque le journal des événements atteint sa taille maximale.
Les valeurs valides sont :
-- DoNotOverwrite : les entrées existantes sont conservées et les nouvelles entrées sont ignorées.
-- OverwriteAsNeeded : chaque nouvelle entrée remplace l'entrée la plus ancienne.
-- OverwriteOlder : les nouveaux événements remplacent les événements antérieurs à la valeur spécifiée par la propriété MinimumRetentionDays. Si aucun événement n'est antérieur à la valeur spécifiée par la propriété MinimumRetentionDays, les nouveaux événements sont ignorés.
Ce paramètre spécifie la valeur de la propriété OverflowAction de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
Obligatoire ? false
Position ? named
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-RetentionDays <int>
Spécifie le nombre minimal de jours pendant lesquels un événement doit rester dans le journal des événements.
Ce paramètre spécifie la valeur de la propriété MinimumRetentionDays de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
Obligatoire ? false
Position ? named
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Confirm [<SwitchParameter>]
Vous invite à confirmer l'exécution de la commande.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-WhatIf [<SwitchParameter>]
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
Aucun
None
SORTIES
Aucun
None
NOTES
Pour utiliser Limit-EventLog sur Windows Vista et les versions ultérieures de Windows, ouvrez Windows PowerShell avec l'option Exécuter en tant qu'administrateur.
Limit-EventLog modifie les propriétés de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique. Pour consulter les paramètres actuels des propriétés de journal des événements, tapez « get-eventlog -list ».
-------------------------- EXEMPLE 1 --------------------------
C:\PS>limit-eventLog -logname "Windows PowerShell" -MaximumSize 20KB
Description
-----------
Cette commande augmente la taille maximale du journal des événements Windows PowerShell sur l'ordinateur local jusqu'à 20 480octets (20 Ko).
-------------------------- EXEMPLE 2 --------------------------
C:\PS>limit-eventlog -logname Security -comp Server01, Server02 -retentionDays 7
Description
-----------
Grâce à cette commande, les événements qui figurent dans le journal de sécurité des ordinateurs Server01 et Server02 sont assurés d'être conservés pendant au moins 7 jours.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>$logs = get-eventlog -list | foreach {$_.log}
C:\PS> limit-eventlog -overflowaction OverwriteOlder -logname $logs
C:\PS> get-eventlog -list
Max(K) Retain OverflowAction Entries Log
------ ------ -------------- ------- ---
15,168 0 OverwriteOlder 3,412 Application
512 0 OverwriteOlder 0 DFS Replication
512 0 OverwriteOlder 17 DxStudio
10,240 7 OverwriteOlder 0 HardwareEvents
512 0 OverwriteOlder 0 Internet Explorer
512 0 OverwriteOlder 0 Key Management Service
16,384 0 OverwriteOlder 4 ODiag
16,384 0 OverwriteOlder 389 OSession Security
15,168 0 OverwriteOlder 19,360 System
15,360 0 OverwriteOlder 15,828 Windows PowerShell
Description
-----------
Ces commandes modifient l'action de dépassement de capacité de tous les journaux des événements sur l'ordinateur local en « OverwriteOlder ».
La première commande obtient le nom de tous les journaux présents sur l'ordinateur local. La deuxième commande définit l'action de dépassement de capacité. La troisième commande affiche les résultats.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=135227
Clear-EventLog
Get-EventLog
Limit-EventLog
New-EventLog
Remove-EventLog
Show-EventLog
Write-EventLog
Get-WinEvent
Limit-EventLog
RÉSUMÉ
Définit les propriétés de journal des événements qui limitent la taille du journal des événements et l'ancienneté de ses entrées.
SYNTAXE
Limit-EventLog [-LogName] <string[]> [-ComputerName <string[]>] [-MaximumSize <Int64>] [-OverFlowAction {OverwriteAsNeeded | OverwriteOlder | DoNotOverwrite}] [-RetentionDays <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
L'applet de commande Limit-EventLog définit la taille maximale d'un journal des événements classique, la durée de conservation de chaque événement et l'action prévue lorsque le journal atteint sa taille maximale. Vous pouvez l'utiliser pour limiter les journaux des événements sur les ordinateurs locaux ou distants.
Les applets de commande contenant le nom EventLog (les applets de commande EventLog) fonctionnent uniquement sur les journaux des événements classiques. Pour obtenir des événements à partir des journaux qui utilisent la technologie Journal des événements Windows sous Windows Vista et les versions ultérieures de Windows, utilisez Get-WinEvent.
PARAMÈTRES
-ComputerName <string[]>
Spécifie un ordinateur distant. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou le nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) ou « localhost ».
Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Limit-EventLog même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.
Obligatoire ? false
Position ? named
Valeur par défaut Ordinateur local
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-LogName <string[]>
Spécifie les journaux des événements. Entrez le nom de journal (la valeur de la propriété Log et non LogDisplayName) d'un ou de plusieurs journaux des événements, en les séparant par des virgules. Les caractères génériques ne sont pas autorisés. Ce paramètre est obligatoire.
Obligatoire ? true
Position ? 1
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-MaximumSize <Int64>
Spécifie la taille maximale des journaux des événements (en octets). Entrez une valeur comprise entre 64 kilo-octets (Ko) et 4 gigaoctets (Go). La valeur doit être divisible par 64 Ko (65 536).
Ce paramètre spécifie la valeur de la propriété MaximumKilobytes de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
Obligatoire ? false
Position ? named
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-OverFlowAction <OverflowAction>
Spécifie l'action prévue lorsque le journal des événements atteint sa taille maximale.
Les valeurs valides sont :
-- DoNotOverwrite : les entrées existantes sont conservées et les nouvelles entrées sont ignorées.
-- OverwriteAsNeeded : chaque nouvelle entrée remplace l'entrée la plus ancienne.
-- OverwriteOlder : les nouveaux événements remplacent les événements antérieurs à la valeur spécifiée par la propriété MinimumRetentionDays. Si aucun événement n'est antérieur à la valeur spécifiée par la propriété MinimumRetentionDays, les nouveaux événements sont ignorés.
Ce paramètre spécifie la valeur de la propriété OverflowAction de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
Obligatoire ? false
Position ? named
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-RetentionDays <int>
Spécifie le nombre minimal de jours pendant lesquels un événement doit rester dans le journal des événements.
Ce paramètre spécifie la valeur de la propriété MinimumRetentionDays de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique.
Obligatoire ? false
Position ? named
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Confirm [<SwitchParameter>]
Vous invite à confirmer l'exécution de la commande.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-WhatIf [<SwitchParameter>]
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
Aucun
None
SORTIES
Aucun
None
NOTES
Pour utiliser Limit-EventLog sur Windows Vista et les versions ultérieures de Windows, ouvrez Windows PowerShell avec l'option Exécuter en tant qu'administrateur.
Limit-EventLog modifie les propriétés de l'objet System.Diagnostics.EventLog qui représente un journal des événements classique. Pour consulter les paramètres actuels des propriétés de journal des événements, tapez « get-eventlog -list ».
-------------------------- EXEMPLE 1 --------------------------
C:\PS>limit-eventLog -logname "Windows PowerShell" -MaximumSize 20KB
Description
-----------
Cette commande augmente la taille maximale du journal des événements Windows PowerShell sur l'ordinateur local jusqu'à 20 480octets (20 Ko).
-------------------------- EXEMPLE 2 --------------------------
C:\PS>limit-eventlog -logname Security -comp Server01, Server02 -retentionDays 7
Description
-----------
Grâce à cette commande, les événements qui figurent dans le journal de sécurité des ordinateurs Server01 et Server02 sont assurés d'être conservés pendant au moins 7 jours.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>$logs = get-eventlog -list | foreach {$_.log}
C:\PS> limit-eventlog -overflowaction OverwriteOlder -logname $logs
C:\PS> get-eventlog -list
Max(K) Retain OverflowAction Entries Log
------ ------ -------------- ------- ---
15,168 0 OverwriteOlder 3,412 Application
512 0 OverwriteOlder 0 DFS Replication
512 0 OverwriteOlder 17 DxStudio
10,240 7 OverwriteOlder 0 HardwareEvents
512 0 OverwriteOlder 0 Internet Explorer
512 0 OverwriteOlder 0 Key Management Service
16,384 0 OverwriteOlder 4 ODiag
16,384 0 OverwriteOlder 389 OSession Security
15,168 0 OverwriteOlder 19,360 System
15,360 0 OverwriteOlder 15,828 Windows PowerShell
Description
-----------
Ces commandes modifient l'action de dépassement de capacité de tous les journaux des événements sur l'ordinateur local en « OverwriteOlder ».
La première commande obtient le nom de tous les journaux présents sur l'ordinateur local. La deuxième commande définit l'action de dépassement de capacité. La troisième commande affiche les résultats.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=135227
Clear-EventLog
Get-EventLog
Limit-EventLog
New-EventLog
Remove-EventLog
Show-EventLog
Write-EventLog
Get-WinEvent
Join-Path
NOM
Join-Path
RÉSUMÉ
Combine un chemin d'accès et un chemin d'accès d'enfant en un seul chemin d'accès. Le fournisseur fournit les séparateurs de chemin d'accès.
SYNTAXE
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Join-Path combine un chemin d'accès et un chemin d'accès d'enfant en un seul chemin d'accès. Le fournisseur fournit les séparateurs de chemin d'accès.
PARAMÈTRES
-ChildPath <string>
Spécifie les éléments à ajouter à la valeur Path. Les caractères génériques sont autorisés. Le paramètre ChildPath est requis, bien que le nom de paramètre (« ChildPath ») soit facultatif.
Obligatoire ? true
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 ». Vous pouvez également entrer un objet PS Credential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-Path <string[]>
Spécifie les chemins principaux auxquels le chemin d'accès enfant est ajouté. Les caractères génériques sont autorisés.
La valeur de Path détermine le fournisseur qui associe les chemins d'accès et ajoute les séparateurs de chemin d'accès. Le paramètre Path est requis, bien que le nom de paramètre (« Path ») soit facultatif.
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue, ByPropertyName)
Accepter les caractères génériques ? false
-Resolve [<SwitchParameter>]
Affiche les éléments qui sont référencés par le chemin d'accès associé.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-UseTransaction [<SwitchParameter>]
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
System.String
Vous pouvez diriger une chaîne qui contient un chemin d'accès vers Join-Path.
SORTIES
System.String
Join-Path retourne une chaîne qui contient le chemin d'accès résultant.
NOTES
Les applets de commande contenant le nom Path (les applets de commande Path) manipulent les noms de chemin d'accès et les retournent dans un format concis pouvant être interprété par tous les fournisseurs Windows PowerShell. Elles sont conçues pour être utilisées dans des programmes et des scripts dans lesquels vous voulez afficher l'intégralité ou une partie d'un nom de chemin d'accès dans un format particulier. Utilisez-les comme Dirname, Normpath, Realpath, Join ou tout autre manipulateur de chemin d'accès.
Vous pouvez utiliser les applets de commande Path avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
L'applet de commande Join-Path est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PSProvider ». Pour plus d'informations, consultez about_Providers.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>join-path -path c:\win* -childpath System*
Description
-----------
Cette commande utilise Join-Path pour combiner le chemin d'accès « c:\Win* » avec le chemin d'accès enfant « System* ». FileSystem, le fournisseur de système de fichiers de Windows PowerShell, associe les chemins d'accès et ajoute le séparateur « \ ».
-------------------------- EXEMPLE 2 --------------------------
C:\PS>join-path c:\win* System* -resolve
Description
-----------
Cette commande affiche les fichiers et les dossiers référencés en associant le chemin d'accès « c:\Win* » et le chemin d'accès enfant « System* ». Elle affiche les mêmes fichiers et dossiers que Get-ChildItem, mais elle affiche le chemin d'accès complet de chaque élément. Dans cette commande, les noms de paramètres optionnels Path et ChildPath sont omis.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve
Description
-----------
Cette commande affiche les clés de Registre de la sous-clé de Registre HKLM\System qui incluent « ControlSet ». Cet exemple montre comment utiliser Join-Path avec le fournisseur Registry de Windows PowerShell.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>join-path -path C:, D:, E:, F: -childpath New
Description
-----------
Cette commande utilise Join-Path pour combiner plusieurs racines de chemin d'accès avec un chemin d'accès enfant.
-------------------------- EXEMPLE 5 --------------------------
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
Description
-----------
Cette commande combine les racines de chaque lecteur de système de fichiers Windows PowerShell dans la console avec le chemin d'accès enfant de Subdir.
La commande utilise l'applet de commande Get-PSDrive pour obtenir les lecteurs Windows PowerShell pris en charge par le fournisseur FileSystem. L'instruction ForEach sélectionne uniquement la propriété Root des objets PSDriveInfo et la combine avec le chemin d'accès enfant spécifié.
La sortie indique que les lecteurs Windows PowerShell présents sur l'ordinateur comportaient un lecteur mappé au répertoire C:\Program Files.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113347
about_Providers
Test-Path
Split-Path
Resolve-Path
Convert-Path
Join-Path
RÉSUMÉ
Combine un chemin d'accès et un chemin d'accès d'enfant en un seul chemin d'accès. Le fournisseur fournit les séparateurs de chemin d'accès.
SYNTAXE
Join-Path [-Path] <string[]> [-ChildPath] <string> [-Credential <PSCredential>] [-Resolve] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Join-Path combine un chemin d'accès et un chemin d'accès d'enfant en un seul chemin d'accès. Le fournisseur fournit les séparateurs de chemin d'accès.
PARAMÈTRES
-ChildPath <string>
Spécifie les éléments à ajouter à la valeur Path. Les caractères génériques sont autorisés. Le paramètre ChildPath est requis, bien que le nom de paramètre (« ChildPath ») soit facultatif.
Obligatoire ? true
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 ». Vous pouvez également entrer un objet PS Credential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-Path <string[]>
Spécifie les chemins principaux auxquels le chemin d'accès enfant est ajouté. Les caractères génériques sont autorisés.
La valeur de Path détermine le fournisseur qui associe les chemins d'accès et ajoute les séparateurs de chemin d'accès. Le paramètre Path est requis, bien que le nom de paramètre (« Path ») soit facultatif.
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue, ByPropertyName)
Accepter les caractères génériques ? false
-Resolve [<SwitchParameter>]
Affiche les éléments qui sont référencés par le chemin d'accès associé.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-UseTransaction [<SwitchParameter>]
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
System.String
Vous pouvez diriger une chaîne qui contient un chemin d'accès vers Join-Path.
SORTIES
System.String
Join-Path retourne une chaîne qui contient le chemin d'accès résultant.
NOTES
Les applets de commande contenant le nom Path (les applets de commande Path) manipulent les noms de chemin d'accès et les retournent dans un format concis pouvant être interprété par tous les fournisseurs Windows PowerShell. Elles sont conçues pour être utilisées dans des programmes et des scripts dans lesquels vous voulez afficher l'intégralité ou une partie d'un nom de chemin d'accès dans un format particulier. Utilisez-les comme Dirname, Normpath, Realpath, Join ou tout autre manipulateur de chemin d'accès.
Vous pouvez utiliser les applets de commande Path avec plusieurs fournisseurs, notamment les fournisseurs FileSystem, Registry et Certificate.
L'applet de commande Join-Path est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PSProvider ». Pour plus d'informations, consultez about_Providers.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>join-path -path c:\win* -childpath System*
Description
-----------
Cette commande utilise Join-Path pour combiner le chemin d'accès « c:\Win* » avec le chemin d'accès enfant « System* ». FileSystem, le fournisseur de système de fichiers de Windows PowerShell, associe les chemins d'accès et ajoute le séparateur « \ ».
-------------------------- EXEMPLE 2 --------------------------
C:\PS>join-path c:\win* System* -resolve
Description
-----------
Cette commande affiche les fichiers et les dossiers référencés en associant le chemin d'accès « c:\Win* » et le chemin d'accès enfant « System* ». Elle affiche les mêmes fichiers et dossiers que Get-ChildItem, mais elle affiche le chemin d'accès complet de chaque élément. Dans cette commande, les noms de paramètres optionnels Path et ChildPath sont omis.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>PS HKLM:\> join-path System *ControlSet* -resolve
Description
-----------
Cette commande affiche les clés de Registre de la sous-clé de Registre HKLM\System qui incluent « ControlSet ». Cet exemple montre comment utiliser Join-Path avec le fournisseur Registry de Windows PowerShell.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>join-path -path C:, D:, E:, F: -childpath New
Description
-----------
Cette commande utilise Join-Path pour combiner plusieurs racines de chemin d'accès avec un chemin d'accès enfant.
-------------------------- EXEMPLE 5 --------------------------
C:\PS>get-psdrive -psprovider filesystem | foreach {$_.root} | join-path -childpath Subdir
Description
-----------
Cette commande combine les racines de chaque lecteur de système de fichiers Windows PowerShell dans la console avec le chemin d'accès enfant de Subdir.
La commande utilise l'applet de commande Get-PSDrive pour obtenir les lecteurs Windows PowerShell pris en charge par le fournisseur FileSystem. L'instruction ForEach sélectionne uniquement la propriété Root des objets PSDriveInfo et la combine avec le chemin d'accès enfant spécifié.
La sortie indique que les lecteurs Windows PowerShell présents sur l'ordinateur comportaient un lecteur mappé au répertoire C:\Program Files.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113347
about_Providers
Test-Path
Split-Path
Resolve-Path
Convert-Path
Invoke-WSManAction
NOM
Invoke-WSManAction
RÉSUMÉ
Appelle une action sur l'objet spécifié par l'URI de ressource et les sélecteurs.
SYNTAXE
Invoke-WSManAction [-ApplicationName <string>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-UseSSL] [-ResourceURI] <Uri> [-Action] <string> [-Authentication <AuthenticationMechanism>] [-FilePath <File>] [-OptionSet <hashtable>] [-SelectorSet <hashtable>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]
Invoke-WSManAction [-ConnectionURI <Uri>] [-ResourceURI] <Uri> [-Action] <string> [-Authentication <AuthenticationMechanism>] [-FilePath <File>] [-OptionSet <hashtable>] [-SelectorSet <hashtable>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]
DESCRIPTION
L'applet de commande Invoke-WSManAction exécute une action sur l'objet qui est spécifié par RESOURCE_URI, les paramètres étant spécifiés par des paires clé-valeur.
Cette applet de commande utilise la couche connexion/transport de WSMan pour exécuter l'action.
PARAMÈTRES
-Action <string>
Indique la méthode à exécuter sur l'objet de gestion spécifié par ResourceURI et les sélecteurs.
Obligatoire ? true
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ApplicationName <string>
Spécifie le nom d'application dans la connexion. La valeur par défaut du paramètre ApplicationName est WSMAN. L
'identificateur complet du point de terminaison distant a le format suivant :
<transport>://<serveur>:<port>/<Nom_Application>
Par exemple :
http://server01:8080/WSMAN
Les services Internet (IIS), qui hébergent la session, transfèrent les demandes avec ce point de terminaison à l'application spécifiée. Ce paramètre par défaut de « WSMAN » convient pour la plupart des utilisations. Il est destiné à être utilisé lorsqu'un grand nombre d'ordinateurs établissent des connexions à distance à un seul ordinateur qui exécute Windows PowerShell. Dans ce cas, IIS héberge les services Web pour la gestion (Gestion des services Web) pour une meilleure efficacité.
Obligatoire ? false
Position ? named
Valeur par défaut wsman
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Authentication <AuthenticationMechanism>
Spécifie le mécanisme d'authentification à utiliser au niveau du serveur. Les valeurs possibles sont les suivantes :
- Basic : Basic est un modèle dans lequel le nom d'utilisateur et le mot de passe sont envoyés en clair au serveur ou au proxy.
- Default : utilise la méthode d'authentification implémentée par le protocole Gestion des services Web. Il s'agit de la valeur par défaut.
- Digest : Digest est un modèle de stimulation/réponse qui utilise une chaîne de données spécifiée par le serveur pour la stimulation.
- Kerberos : l'ordinateur client et le serveur s'authentifient mutuellement à l'aide de certificats Kerberos.
- Negotiate : Negotiate est un modèle de stimulation/réponse qui négocie avec le serveur ou le proxy pour déterminer le modèle à utiliser pour l'authentification. Par exemple, cette valeur de paramètre permet la négociation pour déterminer si le protocole Kerberos ou NTLM est utilisé.
- CredSSP : l'authentification CredSSP (Credential Security Service Provider) permet à l'utilisateur de déléguer des informations d'identification. Cette option est conçue pour les commandes qui s'exécutent sur un seul ordinateur distant, mais qui collectent des données à partir d'autres ordinateurs distants ou qui exécutent des commandes supplémentaires sur d'autres ordinateurs distants.
Attention : CredSSP délègue les informations d'identification de l'utilisateur de l'ordinateur local à un ordinateur distant. Cette pratique augmente le risque de sécurité de l'opération distante. Si l'ordinateur distant n'est pas fiable, lorsque les informations d'identification lui sont passées, elles peuvent être utilisées pour contrôler la session réseau.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ComputerName <string>
Spécifie l'ordinateur sur lequel vous voulez exécuter l'opération de gestion. La valeur peut être un nom de domaine complet, un nom NetBIOS ou une adresse IP. Utilisez le nom de l'ordinateur local, localhost ou un point (.) pour spécifier l'ordinateur local. L'ordinateur local est la valeur par défaut. Lorsque l'ordinateur distant se trouve dans un domaine différent de l'utilisateur, vous devez utiliser un nom de domaine complet. Vous pouvez diriger une valeur vers l'applet de commande pour ce paramètre.
Obligatoire ? false
Position ? named
Valeur par défaut localhost
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ConnectionURI <Uri>
Spécifie le point de terminaison de connexion. Le format de cette chaîne est le suivant :
<Transport>://<Serveur>:<Port>/<Nom_Application>
La chaîne suivante est une valeur au format approprié pour ce paramètre :
http://Server01:8080/WSMAN
L'URI doit être complet.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel. Tapez un nom d'utilisateur, tel que « Utilisateur01 », « Domaine01\Utilisateur01 » ou « Utilisateur@Domaine.com ». Vous pouvez également entrer un objet PSCredential, tel que celui retourné par l'applet de commande Get-Credential. Lorsque vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-FilePath <File>
Spécifie le chemin d'accès d'un fichier qui est utilisé pour mettre à jour une ressource de gestion. Vous spécifiez la ressource de gestion à l'aide du paramètre ResourceURI et du paramètre SelectorSet. Par exemple, la commande suivante utilise le paramètre FilePath :
invoke-wsmanaction -action stopservice -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default
Cette commande appelle la méthode StopService sur le service Spooler en utilisant l'entrée d'un fichier. Le contenu du fichier, Input.xml, est le suivant :
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service"/>
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-OptionSet <hashtable>
Passe un jeu de commutateurs à un service afin de modifier ou d'affiner la nature de la demande. Ces commutateurs sont semblables à ceux utilisés dans les interpréteurs de ligne de commande car ils sont spécifiques au service. Il est possible de spécifier un nombre quelconque d'options.
L'exemple suivant illustre la syntaxe permettant de passer les valeurs 1, 2 et 3 pour les paramètres a, b et c
:
-OptionSet @{a=1;b=2;c=3}
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue, ByPropertyName)
Accepter les caractères génériques ? false
-Port <int>
Spécifie le port à utiliser lorsque le client se connecte au service WinRM. Lorsque le transport est HTTP, le port par défaut est le port 80. Lorsque le transport est HTTPS, le port par défaut est le port 443. Lorsque vous utilisez HTTPS comme transport, la valeur du paramètre ComputerName doit correspondre au nom commun de certificat serveur. Toutefois, si le paramètre SkipCNCheck est spécifié dans le cadre du paramètre SessionOption, le nom commun du certificat du serveur ne doit pas nécessairement correspondre au nom d'hôte du serveur. Le paramètre SkipCNCheck ne doit être utilisé que pour les ordinateurs approuvés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ResourceURI <Uri>
Contient l'URI (Uniform Resource Identifier) de la classe ou de l'instance de la ressource. L'URI est utilisé p
our identifier un type de ressource spécifique, tel que des disques ou des 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
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue, ByPropertyName)
Accepter les caractères génériques ? false
-SelectorSet <hashtable>
Spécifie un ensemble de paires de valeurs permettant de sélectionner des instances de ressource de gestion particulières. Le paramètre SelectorSet est utilisé lorsqu'il existe plusieurs instances de la ressource. La valeur du paramètre SelectorSet doit être une table de hachage.
L'exemple suivant montre comment entrer une valeur pour ce paramètre :
-SelectorSet @{Name="WinRM";ID="yyy"}
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-SessionOption <hashtable>
Définit un jeu d'options étendues pour la session du service Gestion des services Web. Entrez un objet SessionOption que vous créez à l'aide de l'applet de commande New-WSManSessionOption. Pour plus d'informations sur les options disponibles, consultez New-WSManSessionOption.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-UseSSL [<SwitchParameter>]
Spécifie que le protocole SSL (Secure Sockets Layer) doit être utilisé pour établir une connexion à l'ordinateur distant. Par défaut, SSL n'est pas utilisé.
Le service Gestion des services Web chiffre tout le contenu Windows PowerShell qui est transmis via le réseau.
Le paramètre UseSSL vous permet de spécifier HTTPS plutôt que HTTP comme mesure de protection supplémentaire. Si vous spécifiez ce paramètre alors que SSL n'est pas disponible sur le port utilisé pour la connexion, la commande échoue.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ValueSet <hashtable>
Spécifie une table de hachage qui permet de modifier une ressource de gestion. Vous spécifiez la ressource de gestion à l'aide du paramètre ResourceURI et du paramètre SelectorSet. La valeur du paramètre ValueSet doit être une table de hachage.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
Aucun
Cette applet de commande n'accepte aucune entrée.
SORTIES
Aucun
Cette applet de commande ne génère aucune sortie.
NOTES
-------------------------- EXEMPLE 1 --------------------------
C:\PS>invoke-wsmanaction -action startservice -resourceuri wmicimv2/win32_service -selectorset @{name="spooler"} - authentication default
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode StartService de l'instance de classe WMI Win32_Service qui correspond au service Spouleur.
La valeur de retour indique si l'action a réussi. Dans le cas présent, la valeur de retour 0 indique la réussite de l'opération. La valeur de retour 5 indique que le service est déjà démarré.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>invoke-wsmanaction -action stopservice -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:input.xml -authentication default
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode StopService sur le service Spooler en utilisant l'entrée d'un fichier. Le contenu du fichier, Input.xml, est le suivant :
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service"/>
La valeur de retour indique si l'action a réussi. Dans le cas présent, la valeur de retour 0 indique la réussite de l'opération. La valeur de retour 5 indique que le service est déjà démarré.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>invoke-wsmanaction -action create -resourceuri wmicimv2/win32_process -valueset @{commandline="notepad.exe";currentdirectory="C:\"}
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ProcessId : 6356
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode Create de la classe Win32_Process. Il passe deux valeurs de paramètres à la métho
de, Notepad.exe et « C:\ ». En conséquence, un nouveau processus est créé pour exécuter le Bloc-notes, et la valeur définie pour le répertoire actif du nouveau processus est « C:\ ».
-------------------------- EXEMPLE 4 --------------------------
C:\PS>invoke-wsmanaction -action startservice -resourceuri wmicimv2/win32_service -selectorset @{name="spooler"} - computername server01 -authentication default
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode StartService de l'instance de classe WMI Win32_Service qui correspond au service Spouleur. Comme le paramètre ComputerName est spécifié, la commande s'exécute sur l'ordinateur server01 distant.
La valeur de retour indique si l'action a réussi. Dans le cas présent, la valeur de retour 0 indique la réussite de l'opération. La valeur de retour 5 indique que le service est déjà démarré.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkId=141446
Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan
Invoke-WmiMethod
Invoke-WSManAction
RÉSUMÉ
Appelle une action sur l'objet spécifié par l'URI de ressource et les sélecteurs.
SYNTAXE
Invoke-WSManAction [-ApplicationName <string>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-Port <int>] [-UseSSL] [-ResourceURI] <Uri> [-Action] <string> [-Authentication <AuthenticationMechanism>] [-FilePath <File>] [-OptionSet <hashtable>] [-SelectorSet <hashtable>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]
Invoke-WSManAction [-ConnectionURI <Uri>] [-ResourceURI] <Uri> [-Action] <string> [-Authentication <AuthenticationMechanism>] [-FilePath <File>] [-OptionSet <hashtable>] [-SelectorSet <hashtable>] [-SessionOption <hashtable>] [-ValueSet <hashtable>] [<CommonParameters>]
DESCRIPTION
L'applet de commande Invoke-WSManAction exécute une action sur l'objet qui est spécifié par RESOURCE_URI, les paramètres étant spécifiés par des paires clé-valeur.
Cette applet de commande utilise la couche connexion/transport de WSMan pour exécuter l'action.
PARAMÈTRES
-Action <string>
Indique la méthode à exécuter sur l'objet de gestion spécifié par ResourceURI et les sélecteurs.
Obligatoire ? true
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ApplicationName <string>
Spécifie le nom d'application dans la connexion. La valeur par défaut du paramètre ApplicationName est WSMAN. L
'identificateur complet du point de terminaison distant a le format suivant :
<transport>://<serveur>:<port>/<Nom_Application>
Par exemple :
http://server01:8080/WSMAN
Les services Internet (IIS), qui hébergent la session, transfèrent les demandes avec ce point de terminaison à l'application spécifiée. Ce paramètre par défaut de « WSMAN » convient pour la plupart des utilisations. Il est destiné à être utilisé lorsqu'un grand nombre d'ordinateurs établissent des connexions à distance à un seul ordinateur qui exécute Windows PowerShell. Dans ce cas, IIS héberge les services Web pour la gestion (Gestion des services Web) pour une meilleure efficacité.
Obligatoire ? false
Position ? named
Valeur par défaut wsman
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Authentication <AuthenticationMechanism>
Spécifie le mécanisme d'authentification à utiliser au niveau du serveur. Les valeurs possibles sont les suivantes :
- Basic : Basic est un modèle dans lequel le nom d'utilisateur et le mot de passe sont envoyés en clair au serveur ou au proxy.
- Default : utilise la méthode d'authentification implémentée par le protocole Gestion des services Web. Il s'agit de la valeur par défaut.
- Digest : Digest est un modèle de stimulation/réponse qui utilise une chaîne de données spécifiée par le serveur pour la stimulation.
- Kerberos : l'ordinateur client et le serveur s'authentifient mutuellement à l'aide de certificats Kerberos.
- Negotiate : Negotiate est un modèle de stimulation/réponse qui négocie avec le serveur ou le proxy pour déterminer le modèle à utiliser pour l'authentification. Par exemple, cette valeur de paramètre permet la négociation pour déterminer si le protocole Kerberos ou NTLM est utilisé.
- CredSSP : l'authentification CredSSP (Credential Security Service Provider) permet à l'utilisateur de déléguer des informations d'identification. Cette option est conçue pour les commandes qui s'exécutent sur un seul ordinateur distant, mais qui collectent des données à partir d'autres ordinateurs distants ou qui exécutent des commandes supplémentaires sur d'autres ordinateurs distants.
Attention : CredSSP délègue les informations d'identification de l'utilisateur de l'ordinateur local à un ordinateur distant. Cette pratique augmente le risque de sécurité de l'opération distante. Si l'ordinateur distant n'est pas fiable, lorsque les informations d'identification lui sont passées, elles peuvent être utilisées pour contrôler la session réseau.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ComputerName <string>
Spécifie l'ordinateur sur lequel vous voulez exécuter l'opération de gestion. La valeur peut être un nom de domaine complet, un nom NetBIOS ou une adresse IP. Utilisez le nom de l'ordinateur local, localhost ou un point (.) pour spécifier l'ordinateur local. L'ordinateur local est la valeur par défaut. Lorsque l'ordinateur distant se trouve dans un domaine différent de l'utilisateur, vous devez utiliser un nom de domaine complet. Vous pouvez diriger une valeur vers l'applet de commande pour ce paramètre.
Obligatoire ? false
Position ? named
Valeur par défaut localhost
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ConnectionURI <Uri>
Spécifie le point de terminaison de connexion. Le format de cette chaîne est le suivant :
<Transport>://<Serveur>:<Port>/<Nom_Application>
La chaîne suivante est une valeur au format approprié pour ce paramètre :
http://Server01:8080/WSMAN
L'URI doit être complet.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel. Tapez un nom d'utilisateur, tel que « Utilisateur01 », « Domaine01\Utilisateur01 » ou « Utilisateur@Domaine.com ». Vous pouvez également entrer un objet PSCredential, tel que celui retourné par l'applet de commande Get-Credential. Lorsque vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-FilePath <File>
Spécifie le chemin d'accès d'un fichier qui est utilisé pour mettre à jour une ressource de gestion. Vous spécifiez la ressource de gestion à l'aide du paramètre ResourceURI et du paramètre SelectorSet. Par exemple, la commande suivante utilise le paramètre FilePath :
invoke-wsmanaction -action stopservice -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default
Cette commande appelle la méthode StopService sur le service Spooler en utilisant l'entrée d'un fichier. Le contenu du fichier, Input.xml, est le suivant :
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service"/>
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-OptionSet <hashtable>
Passe un jeu de commutateurs à un service afin de modifier ou d'affiner la nature de la demande. Ces commutateurs sont semblables à ceux utilisés dans les interpréteurs de ligne de commande car ils sont spécifiques au service. Il est possible de spécifier un nombre quelconque d'options.
L'exemple suivant illustre la syntaxe permettant de passer les valeurs 1, 2 et 3 pour les paramètres a, b et c
:
-OptionSet @{a=1;b=2;c=3}
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue, ByPropertyName)
Accepter les caractères génériques ? false
-Port <int>
Spécifie le port à utiliser lorsque le client se connecte au service WinRM. Lorsque le transport est HTTP, le port par défaut est le port 80. Lorsque le transport est HTTPS, le port par défaut est le port 443. Lorsque vous utilisez HTTPS comme transport, la valeur du paramètre ComputerName doit correspondre au nom commun de certificat serveur. Toutefois, si le paramètre SkipCNCheck est spécifié dans le cadre du paramètre SessionOption, le nom commun du certificat du serveur ne doit pas nécessairement correspondre au nom d'hôte du serveur. Le paramètre SkipCNCheck ne doit être utilisé que pour les ordinateurs approuvés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ResourceURI <Uri>
Contient l'URI (Uniform Resource Identifier) de la classe ou de l'instance de la ressource. L'URI est utilisé p
our identifier un type de ressource spécifique, tel que des disques ou des 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
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue, ByPropertyName)
Accepter les caractères génériques ? false
-SelectorSet <hashtable>
Spécifie un ensemble de paires de valeurs permettant de sélectionner des instances de ressource de gestion particulières. Le paramètre SelectorSet est utilisé lorsqu'il existe plusieurs instances de la ressource. La valeur du paramètre SelectorSet doit être une table de hachage.
L'exemple suivant montre comment entrer une valeur pour ce paramètre :
-SelectorSet @{Name="WinRM";ID="yyy"}
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-SessionOption <hashtable>
Définit un jeu d'options étendues pour la session du service Gestion des services Web. Entrez un objet SessionOption que vous créez à l'aide de l'applet de commande New-WSManSessionOption. Pour plus d'informations sur les options disponibles, consultez New-WSManSessionOption.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-UseSSL [<SwitchParameter>]
Spécifie que le protocole SSL (Secure Sockets Layer) doit être utilisé pour établir une connexion à l'ordinateur distant. Par défaut, SSL n'est pas utilisé.
Le service Gestion des services Web chiffre tout le contenu Windows PowerShell qui est transmis via le réseau.
Le paramètre UseSSL vous permet de spécifier HTTPS plutôt que HTTP comme mesure de protection supplémentaire. Si vous spécifiez ce paramètre alors que SSL n'est pas disponible sur le port utilisé pour la connexion, la commande échoue.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ValueSet <hashtable>
Spécifie une table de hachage qui permet de modifier une ressource de gestion. Vous spécifiez la ressource de gestion à l'aide du paramètre ResourceURI et du paramètre SelectorSet. La valeur du paramètre ValueSet doit être une table de hachage.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
Aucun
Cette applet de commande n'accepte aucune entrée.
SORTIES
Aucun
Cette applet de commande ne génère aucune sortie.
NOTES
-------------------------- EXEMPLE 1 --------------------------
C:\PS>invoke-wsmanaction -action startservice -resourceuri wmicimv2/win32_service -selectorset @{name="spooler"} - authentication default
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode StartService de l'instance de classe WMI Win32_Service qui correspond au service Spouleur.
La valeur de retour indique si l'action a réussi. Dans le cas présent, la valeur de retour 0 indique la réussite de l'opération. La valeur de retour 5 indique que le service est déjà démarré.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>invoke-wsmanaction -action stopservice -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:input.xml -authentication default
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode StopService sur le service Spooler en utilisant l'entrée d'un fichier. Le contenu du fichier, Input.xml, est le suivant :
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service"/>
La valeur de retour indique si l'action a réussi. Dans le cas présent, la valeur de retour 0 indique la réussite de l'opération. La valeur de retour 5 indique que le service est déjà démarré.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>invoke-wsmanaction -action create -resourceuri wmicimv2/win32_process -valueset @{commandline="notepad.exe";currentdirectory="C:\"}
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ProcessId : 6356
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode Create de la classe Win32_Process. Il passe deux valeurs de paramètres à la métho
de, Notepad.exe et « C:\ ». En conséquence, un nouveau processus est créé pour exécuter le Bloc-notes, et la valeur définie pour le répertoire actif du nouveau processus est « C:\ ».
-------------------------- EXEMPLE 4 --------------------------
C:\PS>invoke-wsmanaction -action startservice -resourceuri wmicimv2/win32_service -selectorset @{name="spooler"} - computername server01 -authentication default
xsi : http://www.w3.org/2001/XMLSchema-instance
p : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim : http://schemas.dmtf.org/wbem/wscim/1/common
lang : en-US
ReturnValue : 0
Description
-----------
Cette commande appelle la méthode StartService de l'instance de classe WMI Win32_Service qui correspond au service Spouleur. Comme le paramètre ComputerName est spécifié, la commande s'exécute sur l'ordinateur server01 distant.
La valeur de retour indique si l'action a réussi. Dans le cas présent, la valeur de retour 0 indique la réussite de l'opération. La valeur de retour 5 indique que le service est déjà démarré.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkId=141446
Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan
Invoke-WmiMethod
Inscription à :
Articles (Atom)