Affichage des articles dont le libellé est PowerShell. Afficher tous les articles
Affichage des articles dont le libellé est PowerShell. Afficher tous les articles
lundi 15 avril 2013
Gerrer les services, la méthode PowerShell en 10 parties. Tous ce que vous devez savoir sur les services et PowerShell. (Anglais)
Un article intéressant en anglais :
Manage services the PowerShell waySeries in 10 parts. All you have to know about services and PowerShell.
jeudi 21 février 2013
Measure-Command
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
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
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
mardi 20 décembre 2011
Invoke-WmiMethod
NOM
Invoke-WmiMethod
RÉSUMÉ
Appelle des méthodes Windows Management Instrumentation (WMI).
SYNTAXE
Invoke-WmiMethod [-Class] <string> [[-ArgumentList] <Object[]>] [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod -InputObject <ManagementObject> [-ArgumentList <Object[]>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod -Path <string> [-ArgumentList <Object[]>] [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
L'applet de commande Invoke-WmiMethod appelle des méthodes WMI.
PARAMÈTRES
-ArgumentList <Object[]>
Spécifie les paramètres à passer à la méthode appelée. La valeur de ce paramètre doit être un tableau d'objets et ils doivent apparaître dans l'ordre requis par la méthode appelée.
Important : une seconde valeur de $null est obligatoire, sinon, la commande générera une erreur, telle que « Impossible d'effectuer un transtypage de l'objet de type « System.Byte » en type « System.Array ». »
L'exemple suivant utilise un tableau d'objets ($binSD) suivi d'une valeur Null ($null) :
PS C:\> $acl = get-acl test.txt
PS C:\> $binSD = $acl.GetSecurityDescriptorBinaryForm()
PS C:\> invoke-wmimethod -class Win32_SecurityDescriptorHelper -Name BinarySDToSDDL -argumentlist $binSD, $null
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-AsJob [<SwitchParameter>]
Exécute la commande en tant que tâche en arrière-plan. Utilisez ce paramètre pour exécuter des commandes dont l'exécution nécessite beaucoup de temps.
Lorsque vous utilisez le paramètre AsJob, la commande retourne un objet qui représente la tâche en arrière-plan, puis affiche l'invite de commandes. Vous pouvez continuer à travailler dans la session pendant l'exécution de la tâche. Si Invoke-WmiMethod est utilisé sur un ordinateur distant, la tâche est créée sur l'ordinateur local, et les résultats provenant d'ordinateurs distants sont automatiquement retournés à l'ordinateur local. Pour gérer la tâche, utilisez les applets de commande contenant le nom Job (les applets de commande Job). Pour obtenir les résultats de la tâche, utilisez l'applet de commande Receive-Job.
Remarque : pour utiliser ce paramètre avec des ordinateurs distants, l'ordinateur local et l'ordinateur distant doivent être configurés pour la communication à distance. En outre, vous devez démarrer Windows PowerShell en utilisant l'option « Exécuter en tant qu'administrateur » dans Windows Vista et les versions ultérieures de Windows. Pour plus d'informations, consultez about_Remote_Requirements.
Pour plus d'informations sur les tâches en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Authentication <AuthenticationLevel>
Spécifie le niveau d'authentification à utiliser avec la connexion WMI. Les valeurs valides sont :
-1 : Unchanged
0 : Default
1 : None (Aucune authentification n'est effectuée.)
2 : Connect (L'authentification est effectuée uniquement lorsque le client établit une relation avec l'application.)
3 : Call (L'authentification est effectuée uniquement au début de chaque appel, quand l'application reçoit une demande.)
4 : Packet (L'authentification est effectuée sur toutes les données reçues du client.)
5 : PacketIntegrity (Toutes les données transférées entre le client et l'application sont authentifiées et vérifiées.)
6 : PacketPrivacy (Les propriétés des autres niveaux d'authentification sont utilisées, et toutes les données sont chiffrées.)
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Authority <string>
Spécifie l'autorité à utiliser pour authentifier la connexion WMI. Vous pouvez spécifier l'authentification Kerberos ou NTLM standard. Pour utiliser NTLM, affectez au paramètre d'autorité la valeur ntlmdomain:<Nom_Domaine>, où <Nom_Domaine> identifie un nom de domaine NTLM valide. Pour utiliser Kerberos, spécifiez kerberos:<Nom_Domaine>\<Nom_Serveur>. Vous ne pouvez pas inclure le paramètre d'autorité lorsque vous vous connectez à l'ordinateur local.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Class <string>
Spécifie la classe WMI qui contient une méthode statique à appeler.
Obligatoire ? true
Position ? 1
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 celui de l'utilisateur, un nom de domaine complet est requis. Vous pouvez également définir la valeur de ce paramètre en redirigeant la valeur vers le paramètre.
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'utili
sateur actuel. Tapez un nom d'utilisateur, tel que « User01 », « Domain01\User01 » ou « User@Contoso.com ». Vous pouvez également entrer un objet PSCredential, tel qu'un objet qui est 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
-EnableAllPrivileges [<SwitchParameter>]
Active tous les privilèges de l'utilisateur actuel avant que la commande ne passe l'appel WMI.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Impersonation <ImpersonationLevel>
Spécifie le niveau d'emprunt d'identité à utiliser. Les valeurs valides sont :
0 : Default (Lit le Registre local pour connaître le niveau d'emprunt d'identité par défaut, qui a généralement la valeur « 3 : Impersonate ».)
1 : Anonymous (Masque les informations d'identification de l'appelant.)
2 : Identify (Permet aux objets d'interroger les informations d'identification de l'appelant.)
3 : Impersonate (Permet aux objets d'utiliser les informations d'identification de l'appelant.)
4 : Delegate (Permet aux objets d'autoriser d'autres objets à utiliser les informations d'identification de l'appelant.)
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <ManagementObject>
Spécifie un objet ManagementObject à utiliser en entrée. Lorsque ce paramètre est utilisé, tous les autres paramètres (sauf les paramètres Flag et Argument) sont ignorés.
Obligatoire ? true
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? false
-Locale <string>
Spécifie les paramètres régionaux par défaut pour les objets WMI. Spécifiez la valeur du paramètre Locale sous forme de tableau au format MS_<LCID> dans l'ordre de préférence.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Name <string>
Spécifie le nom de la méthode à appeler. Ce paramètre est obligatoire et ne peut ni avoir la valeur Null ni être vide.
Obligatoire ? true
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Namespace <string>
Lorsqu'il est utilisé avec le paramètre Class, ce paramètre spécifie l'espace de noms du répertoire de stockage WMI dans lequel figure la classe ou l'objet WMI référencé.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Path <string>
Spécifie le chemin d'accès de l'objet WMI d'une classe WMI, ou spécifie le chemin d'accès de l'objet WMI d'une instance d'une classe WMI. La classe ou l'instance que vous spécifiez doit contenir la méthode spécifiée dans le paramètre Name.
Obligatoire ? true
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ThrottleLimit <int>
Permet à l'utilisateur de spécifier une valeur de limitation pour le nombre d'opérations WMI pouvant être exécutées simultanément. Ce paramètre est utilisé avec le paramètre AsJob. La limite d'accélération s'applique uniquement à la commande actuelle, et non à la session ou à l'ordinateur.
Obligatoire ? false
Position ? named
Valeur par défaut
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
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-wmimethod -path win32_process -name create -argumentlist notepad.exe
__GENUS : 2
__CLASS : __PARAMETERS
__SUPERCLASS :
__DYNASTY : __PARAMETERS
__RELPATH :
__PROPERTY_COUNT : 2
__DERIVATION : {}
__SERVER :
__NAMESPACE :
__PATH :
ProcessId : 4844
ReturnValue : 0
Description
-----------
Cette commande démarre une instance de Bloc-notes en appelant la méthode Create de la classe Win32_Process.
Remarque : la propriété ReturnValue est remplie avec un 0, et la propriété ProcessId est remplie avec un entier (numéro d'identification du processus suivant) si la commande est effectuée.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>invoke-wmimethod -path "CIM_DataFile.Name='C:\scripts\test.txt'" -Name Rename -ArgumentList "C:\scripts\test_bu.txt"
__GENUS : 2
__CLASS : __PARAMETERS
__SUPERCLASS :
__DYNASTY : __PARAMETERS
__RELPATH :
__PROPERTY_COUNT : 1
__DERIVATION : {}
__SERVER :
__NAMESPACE :
__PATH :
ReturnValue : 0
Description
-----------
Cette commande renomme un fichier. Elle utilise le paramètre Path pour référencer une instance de la classe CIM_DataFile. Elle applique ensuite la méthode Rename à cette instance particulière.
Remarque : la propriété ReturnValue est remplie avec un 0 si la commande est effectuée.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113346
Get-WmiObject
Remove-WmiObject
Set-WmiInstance
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance
Invoke-WmiMethod
RÉSUMÉ
Appelle des méthodes Windows Management Instrumentation (WMI).
SYNTAXE
Invoke-WmiMethod [-Class] <string> [[-ArgumentList] <Object[]>] [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod -InputObject <ManagementObject> [-ArgumentList <Object[]>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod -Path <string> [-ArgumentList <Object[]>] [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Invoke-WmiMethod [-Authentication {Default | None | Connect | Call | Packet | PacketIntegrity | PacketPrivacy | Unchanged}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {Default | Anonymous | Identify | Impersonate | Delegate}] [-Locale <string>] [-Namespace <string>] [-Name] <string> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
L'applet de commande Invoke-WmiMethod appelle des méthodes WMI.
PARAMÈTRES
-ArgumentList <Object[]>
Spécifie les paramètres à passer à la méthode appelée. La valeur de ce paramètre doit être un tableau d'objets et ils doivent apparaître dans l'ordre requis par la méthode appelée.
Important : une seconde valeur de $null est obligatoire, sinon, la commande générera une erreur, telle que « Impossible d'effectuer un transtypage de l'objet de type « System.Byte » en type « System.Array ». »
L'exemple suivant utilise un tableau d'objets ($binSD) suivi d'une valeur Null ($null) :
PS C:\> $acl = get-acl test.txt
PS C:\> $binSD = $acl.GetSecurityDescriptorBinaryForm()
PS C:\> invoke-wmimethod -class Win32_SecurityDescriptorHelper -Name BinarySDToSDDL -argumentlist $binSD, $null
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-AsJob [<SwitchParameter>]
Exécute la commande en tant que tâche en arrière-plan. Utilisez ce paramètre pour exécuter des commandes dont l'exécution nécessite beaucoup de temps.
Lorsque vous utilisez le paramètre AsJob, la commande retourne un objet qui représente la tâche en arrière-plan, puis affiche l'invite de commandes. Vous pouvez continuer à travailler dans la session pendant l'exécution de la tâche. Si Invoke-WmiMethod est utilisé sur un ordinateur distant, la tâche est créée sur l'ordinateur local, et les résultats provenant d'ordinateurs distants sont automatiquement retournés à l'ordinateur local. Pour gérer la tâche, utilisez les applets de commande contenant le nom Job (les applets de commande Job). Pour obtenir les résultats de la tâche, utilisez l'applet de commande Receive-Job.
Remarque : pour utiliser ce paramètre avec des ordinateurs distants, l'ordinateur local et l'ordinateur distant doivent être configurés pour la communication à distance. En outre, vous devez démarrer Windows PowerShell en utilisant l'option « Exécuter en tant qu'administrateur » dans Windows Vista et les versions ultérieures de Windows. Pour plus d'informations, consultez about_Remote_Requirements.
Pour plus d'informations sur les tâches en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Authentication <AuthenticationLevel>
Spécifie le niveau d'authentification à utiliser avec la connexion WMI. Les valeurs valides sont :
-1 : Unchanged
0 : Default
1 : None (Aucune authentification n'est effectuée.)
2 : Connect (L'authentification est effectuée uniquement lorsque le client établit une relation avec l'application.)
3 : Call (L'authentification est effectuée uniquement au début de chaque appel, quand l'application reçoit une demande.)
4 : Packet (L'authentification est effectuée sur toutes les données reçues du client.)
5 : PacketIntegrity (Toutes les données transférées entre le client et l'application sont authentifiées et vérifiées.)
6 : PacketPrivacy (Les propriétés des autres niveaux d'authentification sont utilisées, et toutes les données sont chiffrées.)
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Authority <string>
Spécifie l'autorité à utiliser pour authentifier la connexion WMI. Vous pouvez spécifier l'authentification Kerberos ou NTLM standard. Pour utiliser NTLM, affectez au paramètre d'autorité la valeur ntlmdomain:<Nom_Domaine>, où <Nom_Domaine> identifie un nom de domaine NTLM valide. Pour utiliser Kerberos, spécifiez kerberos:<Nom_Domaine>\<Nom_Serveur>. Vous ne pouvez pas inclure le paramètre d'autorité lorsque vous vous connectez à l'ordinateur local.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Class <string>
Spécifie la classe WMI qui contient une méthode statique à appeler.
Obligatoire ? true
Position ? 1
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 celui de l'utilisateur, un nom de domaine complet est requis. Vous pouvez également définir la valeur de ce paramètre en redirigeant la valeur vers le paramètre.
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'utili
sateur actuel. Tapez un nom d'utilisateur, tel que « User01 », « Domain01\User01 » ou « User@Contoso.com ». Vous pouvez également entrer un objet PSCredential, tel qu'un objet qui est 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
-EnableAllPrivileges [<SwitchParameter>]
Active tous les privilèges de l'utilisateur actuel avant que la commande ne passe l'appel WMI.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Impersonation <ImpersonationLevel>
Spécifie le niveau d'emprunt d'identité à utiliser. Les valeurs valides sont :
0 : Default (Lit le Registre local pour connaître le niveau d'emprunt d'identité par défaut, qui a généralement la valeur « 3 : Impersonate ».)
1 : Anonymous (Masque les informations d'identification de l'appelant.)
2 : Identify (Permet aux objets d'interroger les informations d'identification de l'appelant.)
3 : Impersonate (Permet aux objets d'utiliser les informations d'identification de l'appelant.)
4 : Delegate (Permet aux objets d'autoriser d'autres objets à utiliser les informations d'identification de l'appelant.)
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <ManagementObject>
Spécifie un objet ManagementObject à utiliser en entrée. Lorsque ce paramètre est utilisé, tous les autres paramètres (sauf les paramètres Flag et Argument) sont ignorés.
Obligatoire ? true
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? false
-Locale <string>
Spécifie les paramètres régionaux par défaut pour les objets WMI. Spécifiez la valeur du paramètre Locale sous forme de tableau au format MS_<LCID> dans l'ordre de préférence.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Name <string>
Spécifie le nom de la méthode à appeler. Ce paramètre est obligatoire et ne peut ni avoir la valeur Null ni être vide.
Obligatoire ? true
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Namespace <string>
Lorsqu'il est utilisé avec le paramètre Class, ce paramètre spécifie l'espace de noms du répertoire de stockage WMI dans lequel figure la classe ou l'objet WMI référencé.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Path <string>
Spécifie le chemin d'accès de l'objet WMI d'une classe WMI, ou spécifie le chemin d'accès de l'objet WMI d'une instance d'une classe WMI. La classe ou l'instance que vous spécifiez doit contenir la méthode spécifiée dans le paramètre Name.
Obligatoire ? true
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-ThrottleLimit <int>
Permet à l'utilisateur de spécifier une valeur de limitation pour le nombre d'opérations WMI pouvant être exécutées simultanément. Ce paramètre est utilisé avec le paramètre AsJob. La limite d'accélération s'applique uniquement à la commande actuelle, et non à la session ou à l'ordinateur.
Obligatoire ? false
Position ? named
Valeur par défaut
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
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-wmimethod -path win32_process -name create -argumentlist notepad.exe
__GENUS : 2
__CLASS : __PARAMETERS
__SUPERCLASS :
__DYNASTY : __PARAMETERS
__RELPATH :
__PROPERTY_COUNT : 2
__DERIVATION : {}
__SERVER :
__NAMESPACE :
__PATH :
ProcessId : 4844
ReturnValue : 0
Description
-----------
Cette commande démarre une instance de Bloc-notes en appelant la méthode Create de la classe Win32_Process.
Remarque : la propriété ReturnValue est remplie avec un 0, et la propriété ProcessId est remplie avec un entier (numéro d'identification du processus suivant) si la commande est effectuée.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>invoke-wmimethod -path "CIM_DataFile.Name='C:\scripts\test.txt'" -Name Rename -ArgumentList "C:\scripts\test_bu.txt"
__GENUS : 2
__CLASS : __PARAMETERS
__SUPERCLASS :
__DYNASTY : __PARAMETERS
__RELPATH :
__PROPERTY_COUNT : 1
__DERIVATION : {}
__SERVER :
__NAMESPACE :
__PATH :
ReturnValue : 0
Description
-----------
Cette commande renomme un fichier. Elle utilise le paramètre Path pour référencer une instance de la classe CIM_DataFile. Elle applique ensuite la méthode Rename à cette instance particulière.
Remarque : la propriété ReturnValue est remplie avec un 0 si la commande est effectuée.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113346
Get-WmiObject
Remove-WmiObject
Set-WmiInstance
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance
Invoke-Item
NOM
Invoke-Item
RÉSUMÉ
Exécute l'action par défaut sur l'élément spécifié.
SYNTAXE
Invoke-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Invoke-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Invoke-Item exécute l'action par défaut sur l'élément spécifié. Par exemple, elle exécute un fichier exécutable ou ouvre un fichier textuel dans l'application associée au type de fichier textuel. L'action par défaut dépend du type d'élément et est déterminée par le fournisseur Windows PowerShell qui fournit l'accès aux données.
PARAMÈTRES
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utili
sateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, 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
-Exclude <string[]>
Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Filter <string>
Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Include <string[]>
Exécute l'action par défaut uniquement sur les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-LiteralPath <string[]>
Spécifie un chemin d'accès à l'élément. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-Path <string[]>
Spécifie le chemin d'accès de l'élément sélectionné.
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
-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
-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 Invoke-Item.
SORTIES
Aucun
La commande ne génère pas de sortie. Toutefois, la sortie peut être générée par l'élément qu'il appelle.
NOTES
L'applet de commande Invoke-Item 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-PsSProvider ». Pour plus d'informations, consultez about_Providers.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>invoke-item C:\Test\aliasApr04.doc
Description
-----------
Cette commande ouvre le fichier aliasApr04.doc dans Microsoft Office Word. Dans ce cas, l'ouverture dans Word est l'action par défaut pour les fichiers .doc.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>invoke-item "C:\Documents and Settings\Lister\My Documents\*.xls"
Description
-----------
Cette commande ouvre toutes les feuilles de calcul Microsoft Office Excel figurant dans le dossier C:\Documents and Settings\Lister\My Documents. Chaque feuille de calcul est ouverte dans une nouvelle instance d'Excel. Dans ce cas, l'ouverture dans Excel est l'action par défaut pour les fichiers .xls.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113345
about_Providers
Clear-Item
Get-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item
Copy-Item
Invoke-Item
RÉSUMÉ
Exécute l'action par défaut sur l'élément spécifié.
SYNTAXE
Invoke-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Invoke-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Invoke-Item exécute l'action par défaut sur l'élément spécifié. Par exemple, elle exécute un fichier exécutable ou ouvre un fichier textuel dans l'application associée au type de fichier textuel. L'action par défaut dépend du type d'élément et est déterminée par le fournisseur Windows PowerShell qui fournit l'accès aux données.
PARAMÈTRES
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utili
sateur actuel.
Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, 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
-Exclude <string[]>
Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Filter <string>
Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Include <string[]>
Exécute l'action par défaut uniquement sur les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-LiteralPath <string[]>
Spécifie un chemin d'accès à l'élément. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
Obligatoire ? true
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-Path <string[]>
Spécifie le chemin d'accès de l'élément sélectionné.
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
-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
-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 Invoke-Item.
SORTIES
Aucun
La commande ne génère pas de sortie. Toutefois, la sortie peut être générée par l'élément qu'il appelle.
NOTES
L'applet de commande Invoke-Item 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-PsSProvider ». Pour plus d'informations, consultez about_Providers.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>invoke-item C:\Test\aliasApr04.doc
Description
-----------
Cette commande ouvre le fichier aliasApr04.doc dans Microsoft Office Word. Dans ce cas, l'ouverture dans Word est l'action par défaut pour les fichiers .doc.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>invoke-item "C:\Documents and Settings\Lister\My Documents\*.xls"
Description
-----------
Cette commande ouvre toutes les feuilles de calcul Microsoft Office Excel figurant dans le dossier C:\Documents and Settings\Lister\My Documents. Chaque feuille de calcul est ouverte dans une nouvelle instance d'Excel. Dans ce cas, l'ouverture dans Excel est l'action par défaut pour les fichiers .xls.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113345
about_Providers
Clear-Item
Get-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item
Copy-Item
Inscription à :
Articles (Atom)