NOM
Copy-ItemProperty
RÉSUMÉ
Copie une propriété et une valeur d'un emplacement spécifié vers un autre emplacement.
SYNTAXE
Copy-ItemProperty [-LiteralPath] <string[]> [-Destination] <string> [-Name] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Copy-ItemProperty [-Path] <string[]> [-Destination] <string> [-Name] <string> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Copy-ItemProperty copie une propriété et une valeur d'un emplacement spécifié dans un autre emplacement. Par exemple, vous pouvez utiliser Copy-ItemProperty pour copier une ou plusieurs entrées de Registre d'une clé de Registre dans une autre clé de Registre.
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
-Destination <string>
Spécifie le chemin d'accès à l'emplacement de destination.
Obligatoire ? true
Position ? 2
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. 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
-Force [<SwitchParameter>]
Permet à l'applet de commande de remplacer des restrictions telles que la modification des noms de fichiers existants, en évitant que la sécurité soit compromise.
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[]>
Spécifie uniquement les éléments affectés par l'applet de commande, en excluant tous les autres.
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 à la propriété d'é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
-Name <string>
Spécifie le nom de la propriété à copier.
Obligatoire ? true
Position ? 3
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByPropertyName)
Accepter les caractères génériques ? false
-PassThru [<SwitchParameter>]
Retourne un objet représentant la propriété d'élément copiée. Par défaut, cette applet de commande ne génère aucune sortie.
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 à la propriété à copier.
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 Copy-ItemProperty.
SORTIES
Aucun ou System.Management.Automation.PSCustomObject
Lorsque vous utilisez le paramètre PassThru, Copy-ItemProperty génère un PsCustomObject qui représente la propriété d'élément copiée. Sinon, cette applet de commande ne génère aucune sortie.
NOTES
L'applet de commande Copy-ItemProperty 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>copy-itemproperty -path MyApplication -destination HKLM:\Software\MyApplicationRev2 -name MyProperty
Description
-----------
Cette commande copie la propriété MyProperty de la clé de Registre MyApplication vers la clé de Registre MyApplicationRev2.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113293
about_Providers
Clear-ItemProperty
New-ItemProperty
Move-ItemProperty
Rename-ItemProperty
Get-ItemProperty
Set-ItemProperty
vendredi 28 octobre 2011
Copy-Item
NOM
Copy-Item
RÉSUMÉ
Copie un élément d'un emplacement vers un autre dans un espace de noms.
SYNTAXE
Copy-Item [-LiteralPath] <string[]> [[-Destination] <string>] [-Container] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Copy-Item [-Path] <string[]> [[-Destination] <string>] [-Container] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Copy-Item copie un élément d'un emplacement vers un autre dans un espace de noms. Copy-Item ne supprime pas les éléments qui sont copiés. Les éléments spécifiques copiés par l'applet de commande varient en fonction des fournisseurs Windows PowerShell disponibles. Par exemple, lorsqu'elle est utilisée avec le fournisseur FileSystem, elle copie des fichiers et des répertoires, tandis que lors de son utilisation avec le fournisseur Registry, elle copie des clés et des entrées de Registre.
PARAMÈTRES
-Container [<SwitchParameter>]
Préserve les objets du conteneur pendant l'opération de copie.
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 « 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
-Destination <string>
Spécifie le chemin d'accès de l'emplacement où les éléments doivent être copiés.
Obligatoire ? false
Position ? 2
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. 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
-Force [<SwitchParameter>]
Permet à l'applet de commande de copier des éléments qui ne peuvent pas être changés autrement, tel que la copie sur un fichier ou un alias en lecture seule.
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[]>
Spécifie uniquement les éléments affectés par l'applet de commande, en excluant tous les autres.
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 du paramètre LiteralPath est utilisée exactement comme elle est tapée. 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
-PassThru [<SwitchParameter>]
Retourne un objet représentant chaque élément copié. Par défaut, cette applet de commande ne génère aucune sortie.
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 aux éléments à copier.
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
-Recurse [<SwitchParameter>]
Spécifie une copie récursive.
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
-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 Copy-ItemProperty.
SORTIES
Aucun ou un objet représentant l'élément copié.
Lorsque vous utilisez le paramètre PassThru, Copy-Item retourne un objet qui représente l'élément copié. Sinon, cette applet de commande ne génère aucune sortie.
NOTES
Copy-Item est semblable aux commandes « cp » ou « copy » dans d'autres interpéteurs de commande.
L'applet de commande Copy-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-PsProvider ». Pour plus d'informations, consultez about_Providers.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>copy-item C:\Wabash\Logfiles\mar1604.log.txt -destination C:\Presentation
Description
-----------
Cette commande copie le fichier mar1604.log.txt vers le répertoire C:\Presentation. Elle ne supprime pas le fichier d'origine.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>copy-item C:\Logfiles -destination C:\Drawings -recurse
Description
-----------
Cette commande copie l'intégralité du contenu du répertoire Logfiles vers le répertoire Drawings. Si les sous-répertoires du répertoire source contiennent des fichiers, ces sous-répertoires sont également copiés avec l'intégralité de leur arborescence de fichiers. Par défaut, le paramètre Container a la valeur true. Ainsi, la structure du répertoire est préservée.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>copy-item C:\Logfiles -destination C:\Drawings\Logs -recurse
Description
-----------
Cette commande copie le contenu du répertoire C:\Logfiles vers le répertoire C:\Drawings\Logs. Elle crée également le sous-répertoire \Logs s'il n'existe pas déjà.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113292
about_Providers
Clear-Item
Get-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item
Copy-Item
RÉSUMÉ
Copie un élément d'un emplacement vers un autre dans un espace de noms.
SYNTAXE
Copy-Item [-LiteralPath] <string[]> [[-Destination] <string>] [-Container] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Copy-Item [-Path] <string[]> [[-Destination] <string>] [-Container] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-PassThru] [-Recurse] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Copy-Item copie un élément d'un emplacement vers un autre dans un espace de noms. Copy-Item ne supprime pas les éléments qui sont copiés. Les éléments spécifiques copiés par l'applet de commande varient en fonction des fournisseurs Windows PowerShell disponibles. Par exemple, lorsqu'elle est utilisée avec le fournisseur FileSystem, elle copie des fichiers et des répertoires, tandis que lors de son utilisation avec le fournisseur Registry, elle copie des clés et des entrées de Registre.
PARAMÈTRES
-Container [<SwitchParameter>]
Préserve les objets du conteneur pendant l'opération de copie.
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 « 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
-Destination <string>
Spécifie le chemin d'accès de l'emplacement où les éléments doivent être copiés.
Obligatoire ? false
Position ? 2
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. 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
-Force [<SwitchParameter>]
Permet à l'applet de commande de copier des éléments qui ne peuvent pas être changés autrement, tel que la copie sur un fichier ou un alias en lecture seule.
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[]>
Spécifie uniquement les éléments affectés par l'applet de commande, en excluant tous les autres.
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 du paramètre LiteralPath est utilisée exactement comme elle est tapée. 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
-PassThru [<SwitchParameter>]
Retourne un objet représentant chaque élément copié. Par défaut, cette applet de commande ne génère aucune sortie.
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 aux éléments à copier.
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
-Recurse [<SwitchParameter>]
Spécifie une copie récursive.
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
-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 Copy-ItemProperty.
SORTIES
Aucun ou un objet représentant l'élément copié.
Lorsque vous utilisez le paramètre PassThru, Copy-Item retourne un objet qui représente l'élément copié. Sinon, cette applet de commande ne génère aucune sortie.
NOTES
Copy-Item est semblable aux commandes « cp » ou « copy » dans d'autres interpéteurs de commande.
L'applet de commande Copy-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-PsProvider ». Pour plus d'informations, consultez about_Providers.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>copy-item C:\Wabash\Logfiles\mar1604.log.txt -destination C:\Presentation
Description
-----------
Cette commande copie le fichier mar1604.log.txt vers le répertoire C:\Presentation. Elle ne supprime pas le fichier d'origine.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>copy-item C:\Logfiles -destination C:\Drawings -recurse
Description
-----------
Cette commande copie l'intégralité du contenu du répertoire Logfiles vers le répertoire Drawings. Si les sous-répertoires du répertoire source contiennent des fichiers, ces sous-répertoires sont également copiés avec l'intégralité de leur arborescence de fichiers. Par défaut, le paramètre Container a la valeur true. Ainsi, la structure du répertoire est préservée.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>copy-item C:\Logfiles -destination C:\Drawings\Logs -recurse
Description
-----------
Cette commande copie le contenu du répertoire C:\Logfiles vers le répertoire C:\Drawings\Logs. Elle crée également le sous-répertoire \Logs s'il n'existe pas déjà.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113292
about_Providers
Clear-Item
Get-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item
ConvertTo-Xml
NOM
ConvertTo-XML
RÉSUMÉ
Crée une représentation XML d'un objet.
SYNTAXE
ConvertTo-XML [-InputObject] <psobject> [-As <string>] [-Depth <int>] [-NoTypeInformation] [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertTo-Xml crée une représentation XML d'un ou plusieurs objets Microsoft .NET Framework. Pour utiliser cette applet de commande, dirigez un ou plusieurs objets vers l'applet de commande ou utilisez le paramètre InputObject pour spécifier l'objet.
Lorsque vous dirigez plusieurs objets vers ConvertTo-XML ou que vous utilisez le paramètre InputObject pour envoyer plusieurs objets, ConvertTo-XML retourne un document XML unique qui inclut des représentations de tous les objets.
Cette applet de commande est semblable à l'applet de commande Export-Clixml, à ceci près que Export-Clixml stocke le contenu XML obtenu dans un fichier. ConvertTo-XML retourne le contenu XML, que vous pouvez donc continuer à traiter dans Windows PowerShell.
PARAMÈTRES
-As <string>
Détermine le format de sortie. Les valeurs valides sont :
-- String : retourne une chaîne unique.
-- Stream : retourne un tableau de chaînes.
-- Document : retourne un objet XmlDocument.
La valeur par défaut est Stream.
Obligatoire ? false
Position ? named
Valeur par défaut Stream
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Depth <int>
Spécifie combien de niveaux d'objets contenus sont inclus dans la représentation XML. La valeur par défaut est 1.
Par exemple, si les propriétés d'objet contiennent également des objets, vous devez spécifier le niveau d'imbrication 2 pour enregistrer une représentation XML des propriétés des objets contenus.
La valeur par défaut peut être remplacée pour le type d'objet dans les fichiers Types.ps1xml. Pour plus d'informations, consultez about_Types.ps1xml.
Obligatoire ? false
Position ? named
Valeur par défaut 1
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <psobject>
Spécifie l'objet à convertir. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir ces objets. Vous pouvez également diriger les objets vers ConvertTo-XML.
Obligatoire ? true
Position ? 1
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? true
-NoTypeInformation [<SwitchParameter>]
Omet l'attribut Type des nouds d'objet.
Obligatoire ? false
Position ? named
Valeur par défaut False
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.Management.Automation.PSObject
Vous pouvez diriger n'importe quel objet vers ConvertTo-XML.
SORTIES
System.String ou System.Xml.XmlDocument
La valeur du paramètre As détermine le type d'objet retourné par ConvertTo-XML.
NOTES
-------------------------- EXEMPLE 1 --------------------------
C:\PS>get-date | convertto-xml
Description
-----------
Cette commande convertit la date actuelle (objet DateTime) au format XML.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>convertto-xml -as Document -inputObject (get-process) -depth 3
Description
-----------
Cette commande convertit les objets processus représentant tous les processus de l'ordinateur en un document XML. Les objets sont développés sur une profondeur de 3 niveaux.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=135204
Export-Clixml
Import-Clixml
ConvertTo-Html
ConvertTo-Csv
ConvertTo-XML
RÉSUMÉ
Crée une représentation XML d'un objet.
SYNTAXE
ConvertTo-XML [-InputObject] <psobject> [-As <string>] [-Depth <int>] [-NoTypeInformation] [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertTo-Xml crée une représentation XML d'un ou plusieurs objets Microsoft .NET Framework. Pour utiliser cette applet de commande, dirigez un ou plusieurs objets vers l'applet de commande ou utilisez le paramètre InputObject pour spécifier l'objet.
Lorsque vous dirigez plusieurs objets vers ConvertTo-XML ou que vous utilisez le paramètre InputObject pour envoyer plusieurs objets, ConvertTo-XML retourne un document XML unique qui inclut des représentations de tous les objets.
Cette applet de commande est semblable à l'applet de commande Export-Clixml, à ceci près que Export-Clixml stocke le contenu XML obtenu dans un fichier. ConvertTo-XML retourne le contenu XML, que vous pouvez donc continuer à traiter dans Windows PowerShell.
PARAMÈTRES
-As <string>
Détermine le format de sortie. Les valeurs valides sont :
-- String : retourne une chaîne unique.
-- Stream : retourne un tableau de chaînes.
-- Document : retourne un objet XmlDocument.
La valeur par défaut est Stream.
Obligatoire ? false
Position ? named
Valeur par défaut Stream
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Depth <int>
Spécifie combien de niveaux d'objets contenus sont inclus dans la représentation XML. La valeur par défaut est 1.
Par exemple, si les propriétés d'objet contiennent également des objets, vous devez spécifier le niveau d'imbrication 2 pour enregistrer une représentation XML des propriétés des objets contenus.
La valeur par défaut peut être remplacée pour le type d'objet dans les fichiers Types.ps1xml. Pour plus d'informations, consultez about_Types.ps1xml.
Obligatoire ? false
Position ? named
Valeur par défaut 1
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <psobject>
Spécifie l'objet à convertir. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir ces objets. Vous pouvez également diriger les objets vers ConvertTo-XML.
Obligatoire ? true
Position ? 1
Valeur par défaut Aucun
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? true
-NoTypeInformation [<SwitchParameter>]
Omet l'attribut Type des nouds d'objet.
Obligatoire ? false
Position ? named
Valeur par défaut False
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.Management.Automation.PSObject
Vous pouvez diriger n'importe quel objet vers ConvertTo-XML.
SORTIES
System.String ou System.Xml.XmlDocument
La valeur du paramètre As détermine le type d'objet retourné par ConvertTo-XML.
NOTES
-------------------------- EXEMPLE 1 --------------------------
C:\PS>get-date | convertto-xml
Description
-----------
Cette commande convertit la date actuelle (objet DateTime) au format XML.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>convertto-xml -as Document -inputObject (get-process) -depth 3
Description
-----------
Cette commande convertit les objets processus représentant tous les processus de l'ordinateur en un document XML. Les objets sont développés sur une profondeur de 3 niveaux.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=135204
Export-Clixml
Import-Clixml
ConvertTo-Html
ConvertTo-Csv
ConvertTo-SecureString
NOM
ConvertTo-SecureString
RÉSUMÉ
Convertit des chaînes standard chiffrées en chaînes sécurisées. Elle peut aussi convertir du texte brut en chaînes sécurisées. Elle est utilisée avec ConvertFrom-SecureString et Read-Host.
SYNTAXE
ConvertTo-SecureString [-Key <Byte[]>] [-String] <string> [<CommonParameters>]
ConvertTo-SecureString [[-AsPlainText]] [[-Force]] [-String] <string> [<CommonParameters>]
ConvertTo-SecureString [[-SecureKey] <SecureString>] [-String] <string> [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertTo-SecureString convertit des chaînes standard chiffrées en chaînes sécurisées. Elle peut aussi convertir du texte brut en chaînes sécurisées. Elle est utilisée avec ConvertFrom-SecureString et Read-Host. La chaîne sécurisée créée par l'applet de commande peut être utilisée avec des applets de commande ou des fonctions qui requièrent un paramètre de type SecureString. La chaîne sécurisée peut être reconvertie en chaîne standard chiffrée à l'aide de l'applet de commande ConvertFrom-SecureString. Cela permet son stockage dans un fichier pour une utilisation ultérieure.
Si la chaîne standard en cours de conversion a été chiffrée avec ConvertFrom-SecureString en utilisant une clé spécifiée, cette clé doit être fournie comme valeur du paramètre Key ou SecureKey de l'applet de commande ConvertTo-SecureString.
PARAMÈTRES
-AsPlainText [<SwitchParameter>]
Spécifie une chaîne de texte brut à convertir en chaîne sécurisée. Les applets de commande SecureString permettent de protéger du texte confidentiel. Le texte est chiffré pour en préserver la confidentialité et est supprimé de la mémoire de l'ordinateur après utilisation. Si vous utilisez ce paramètre pour fournir du texte brut en entrée, le système ne peut pas protéger cette entrée de la même manière. Pour utiliser ce paramètre, vous devez également spécifier le paramètre Force.
Obligatoire ? false
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Force [<SwitchParameter>]
Vérifie que vous comprenez les conséquences de l'utilisation du paramètre AsPlainText et vous invite à confirmer que vous souhaitez toujours l'utiliser.
Obligatoire ? false
Position ? 3
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Key <Byte[]>
Spécifie la clé de chiffrement à utiliser lors de la conversion d'une chaîne sécurisée en chaîne standard chiffrée. Les longueurs de clé valides sont 16, 24 et 32 octets.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-SecureKey <SecureString>
Spécifie la clé de chiffrement à utiliser lors de la conversion d'une chaîne sécurisée en chaîne standard chiffrée. La clé doit être fournie sous forme de chaîne sécurisée. La chaîne sécurisée est convertie en tableau d'octets avant d'être utilisée comme clé. Les longueurs de clé valides sont 16, 24 et 32 octets.
Obligatoire ? false
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-String <string>
Spécifie la chaîne à convertir en chaîne sécurisée.
Obligatoire ? true
Position ? 1
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.String
Vous pouvez diriger une chaîne standard chiffrée vers ConvertTo-SecureString.
SORTIES
System.Security.SecureString
ConvertTo-SecureString retourne un objet SecureString.
NOTES
-------------------------- EXEMPLE 1 --------------------------
C:\PS>$secure = read-host -assecurestring
C:\PS> $secure
System.Security.SecureString
C:\PS> $encrypted = convertfrom-securestring -securestring $secure
C:\PS> $encrypted
01000000d08c9ddf0115d1118c7a00c04fc297eb010000001a114d45b8dd3f4aa11ad7c0abdae9800000000002000000000003660000a800000
0100000005df63cea84bfb7d70bd6842e7
efa79820000000004800000a000000010000000f10cd0f4a99a8d5814d94e0687d7430b100000008bf11f1960158405b2779613e9352c6d1400
0000e6b7bf46a9d485ff211b9b2a2df3bd
6eb67aae41
C:\PS> $secure2 = convertto-securestring -string $encrypted
C:\PS> $secure2
System.Security.SecureString
Description
-----------
Cet exemple montre comment créer une chaîne sécurisée à partir de l'entrée utilisateur, convertir cette chaîne sécurisée en chaîne standard chiffrée, puis reconvertir la chaîne standard chiffrée en chaîne sécurisée.
La première commande utilise le paramètre AsSecureString de l'applet de commande Read-Host pour créer une chaîne sécurisée. Une fois la commande entrée, tous les caractères que vous tapez sont convertis en chaîne sécurisée, puis enregistrés dans la variable $secure.
La deuxième commande affiche le contenu de la variable $secure. Étant donné que la variable $secure contient une chaîne sécurisée, Windows PowerShell affiche uniquement le type System.Security.SecureString.
La troisième commande utilise l'applet de commande ConvertFrom-SecureString pour convertir la chaîne sécurisée stockée dans la variable $secure en chaîne standard chiffrée. Elle enregistre le résultat dans la variable $encrypted.
La quatrième commande affiche la chaîne chiffrée dans la valeur de la variable $encrypted.
La cinquième commande utilise l'applet de commande ConvertTo-SecureString pour reconvertir la chaîne standard chiffrée stockée dans la variable $encrypted en chaîne sécurisée. Elle enregistre le résultat dans la variable $secure2.
La sixième commande affiche la valeur de la variable $secure2. Le type SecureString indique que la commande a réussi.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>$secure = read-host -assecurestring
C:\PS> $encrypted = convertfrom-securestring -secureString $secure -key (1..16)
C:\PS> $encrypted | set-content encrypted.txt
C:\PS> $secure2 = get-content encrypted.txt | convertto-securestring -key (1..16)
Description
-----------
Cet exemple montre comment créer une chaîne sécurisée à partir d'une chaîne standard chiffrée enregistrée dans un fichier.
La première commande utilise le paramètre AsSecureString de l'applet de commande Read-Host pour créer une chaîne sécurisée. Une fois la commande entrée, tous les caractères que vous tapez sont convertis en chaîne sécurisée, puis enregistrés dans la variable $secure.
La deuxième commande utilise l'applet de commande ConvertFrom-SecureString pour convertir la chaîne sécurisée stockée la variable $secure en chaîne standard chiffrée à l'aide de la clé spécifiée. Le contenu est enregistré dans la variable $encrypted.
La troisième commande utilise un opérateur de pipeline (|) pour envoyer la valeur de la variable $encrypted à l'applet de commande Set-Content, qui enregistre la valeur dans le fichier Encrypted.txt.
La quatrième commande utilise l'applet de commande Get-Content pour obtenir la chaîne standard chiffrée stockée dans le fichier Encrypted.txt. Elle utilise un opérateur de pipeline pour envoyer la chaîne chiffrée à l'applet de commande ConvertTo-SecureString, qui la convertit en une chaîne sécurisée à l'aide de la clé spécifiée. Les résultats sont enregistrés dans la variable $secure2.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>$secure_string_pwd = convertto-securestring "P@ssW0rD!" -asplaintext -force
Description
-----------
Cette commande convertit la chaîne de texte brut « P@ssW0rD! » en chaîne sécurisée et stocke le résultat dans la variable $secure_string_pwd. Pour utiliser le paramètre AsPlainText, le paramètre Force doit également être inclus dans la commande.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113291
ConvertFrom-SecureString
Read-Host
ConvertTo-SecureString
RÉSUMÉ
Convertit des chaînes standard chiffrées en chaînes sécurisées. Elle peut aussi convertir du texte brut en chaînes sécurisées. Elle est utilisée avec ConvertFrom-SecureString et Read-Host.
SYNTAXE
ConvertTo-SecureString [-Key <Byte[]>] [-String] <string> [<CommonParameters>]
ConvertTo-SecureString [[-AsPlainText]] [[-Force]] [-String] <string> [<CommonParameters>]
ConvertTo-SecureString [[-SecureKey] <SecureString>] [-String] <string> [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertTo-SecureString convertit des chaînes standard chiffrées en chaînes sécurisées. Elle peut aussi convertir du texte brut en chaînes sécurisées. Elle est utilisée avec ConvertFrom-SecureString et Read-Host. La chaîne sécurisée créée par l'applet de commande peut être utilisée avec des applets de commande ou des fonctions qui requièrent un paramètre de type SecureString. La chaîne sécurisée peut être reconvertie en chaîne standard chiffrée à l'aide de l'applet de commande ConvertFrom-SecureString. Cela permet son stockage dans un fichier pour une utilisation ultérieure.
Si la chaîne standard en cours de conversion a été chiffrée avec ConvertFrom-SecureString en utilisant une clé spécifiée, cette clé doit être fournie comme valeur du paramètre Key ou SecureKey de l'applet de commande ConvertTo-SecureString.
PARAMÈTRES
-AsPlainText [<SwitchParameter>]
Spécifie une chaîne de texte brut à convertir en chaîne sécurisée. Les applets de commande SecureString permettent de protéger du texte confidentiel. Le texte est chiffré pour en préserver la confidentialité et est supprimé de la mémoire de l'ordinateur après utilisation. Si vous utilisez ce paramètre pour fournir du texte brut en entrée, le système ne peut pas protéger cette entrée de la même manière. Pour utiliser ce paramètre, vous devez également spécifier le paramètre Force.
Obligatoire ? false
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Force [<SwitchParameter>]
Vérifie que vous comprenez les conséquences de l'utilisation du paramètre AsPlainText et vous invite à confirmer que vous souhaitez toujours l'utiliser.
Obligatoire ? false
Position ? 3
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Key <Byte[]>
Spécifie la clé de chiffrement à utiliser lors de la conversion d'une chaîne sécurisée en chaîne standard chiffrée. Les longueurs de clé valides sont 16, 24 et 32 octets.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-SecureKey <SecureString>
Spécifie la clé de chiffrement à utiliser lors de la conversion d'une chaîne sécurisée en chaîne standard chiffrée. La clé doit être fournie sous forme de chaîne sécurisée. La chaîne sécurisée est convertie en tableau d'octets avant d'être utilisée comme clé. Les longueurs de clé valides sont 16, 24 et 32 octets.
Obligatoire ? false
Position ? 2
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-String <string>
Spécifie la chaîne à convertir en chaîne sécurisée.
Obligatoire ? true
Position ? 1
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.String
Vous pouvez diriger une chaîne standard chiffrée vers ConvertTo-SecureString.
SORTIES
System.Security.SecureString
ConvertTo-SecureString retourne un objet SecureString.
NOTES
-------------------------- EXEMPLE 1 --------------------------
C:\PS>$secure = read-host -assecurestring
C:\PS> $secure
System.Security.SecureString
C:\PS> $encrypted = convertfrom-securestring -securestring $secure
C:\PS> $encrypted
01000000d08c9ddf0115d1118c7a00c04fc297eb010000001a114d45b8dd3f4aa11ad7c0abdae9800000000002000000000003660000a800000
0100000005df63cea84bfb7d70bd6842e7
efa79820000000004800000a000000010000000f10cd0f4a99a8d5814d94e0687d7430b100000008bf11f1960158405b2779613e9352c6d1400
0000e6b7bf46a9d485ff211b9b2a2df3bd
6eb67aae41
C:\PS> $secure2 = convertto-securestring -string $encrypted
C:\PS> $secure2
System.Security.SecureString
Description
-----------
Cet exemple montre comment créer une chaîne sécurisée à partir de l'entrée utilisateur, convertir cette chaîne sécurisée en chaîne standard chiffrée, puis reconvertir la chaîne standard chiffrée en chaîne sécurisée.
La première commande utilise le paramètre AsSecureString de l'applet de commande Read-Host pour créer une chaîne sécurisée. Une fois la commande entrée, tous les caractères que vous tapez sont convertis en chaîne sécurisée, puis enregistrés dans la variable $secure.
La deuxième commande affiche le contenu de la variable $secure. Étant donné que la variable $secure contient une chaîne sécurisée, Windows PowerShell affiche uniquement le type System.Security.SecureString.
La troisième commande utilise l'applet de commande ConvertFrom-SecureString pour convertir la chaîne sécurisée stockée dans la variable $secure en chaîne standard chiffrée. Elle enregistre le résultat dans la variable $encrypted.
La quatrième commande affiche la chaîne chiffrée dans la valeur de la variable $encrypted.
La cinquième commande utilise l'applet de commande ConvertTo-SecureString pour reconvertir la chaîne standard chiffrée stockée dans la variable $encrypted en chaîne sécurisée. Elle enregistre le résultat dans la variable $secure2.
La sixième commande affiche la valeur de la variable $secure2. Le type SecureString indique que la commande a réussi.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>$secure = read-host -assecurestring
C:\PS> $encrypted = convertfrom-securestring -secureString $secure -key (1..16)
C:\PS> $encrypted | set-content encrypted.txt
C:\PS> $secure2 = get-content encrypted.txt | convertto-securestring -key (1..16)
Description
-----------
Cet exemple montre comment créer une chaîne sécurisée à partir d'une chaîne standard chiffrée enregistrée dans un fichier.
La première commande utilise le paramètre AsSecureString de l'applet de commande Read-Host pour créer une chaîne sécurisée. Une fois la commande entrée, tous les caractères que vous tapez sont convertis en chaîne sécurisée, puis enregistrés dans la variable $secure.
La deuxième commande utilise l'applet de commande ConvertFrom-SecureString pour convertir la chaîne sécurisée stockée la variable $secure en chaîne standard chiffrée à l'aide de la clé spécifiée. Le contenu est enregistré dans la variable $encrypted.
La troisième commande utilise un opérateur de pipeline (|) pour envoyer la valeur de la variable $encrypted à l'applet de commande Set-Content, qui enregistre la valeur dans le fichier Encrypted.txt.
La quatrième commande utilise l'applet de commande Get-Content pour obtenir la chaîne standard chiffrée stockée dans le fichier Encrypted.txt. Elle utilise un opérateur de pipeline pour envoyer la chaîne chiffrée à l'applet de commande ConvertTo-SecureString, qui la convertit en une chaîne sécurisée à l'aide de la clé spécifiée. Les résultats sont enregistrés dans la variable $secure2.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>$secure_string_pwd = convertto-securestring "P@ssW0rD!" -asplaintext -force
Description
-----------
Cette commande convertit la chaîne de texte brut « P@ssW0rD! » en chaîne sécurisée et stocke le résultat dans la variable $secure_string_pwd. Pour utiliser le paramètre AsPlainText, le paramètre Force doit également être inclus dans la commande.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113291
ConvertFrom-SecureString
Read-Host
ConvertTo-Html
NOM
ConvertTo-Html
RÉSUMÉ
Convertit des objets Microsoft .NET Framework au format HTML pouvant être affiché dans un navigateur Web.
SYNTAXE
ConvertTo-Html [[-Head] <string[]>] [[-Title] <string>] [[-Body] <string[]>] [-CssUri <Uri>] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]
ConvertTo-Html [-Fragment] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[ ]>] [-PreContent <string[]>] [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertTo-Html convertit des objets .NET Framework au format HTML pouvant être affiché dans un navigateur Web. Vous pouvez utiliser cette applet de commande pour afficher la sortie d'une commande dans une page Web.
Vous pouvez utiliser les paramètres de ConvertTo-Html pour sélectionner des propriétés d'objet, pour spécifier un format de table ou de liste, pour indiquer le titre de la page HTML, pour ajouter du texte avant et après l'objet et pour retourner uniquement un fragment de table ou de liste, au lieu d'une page DTD stricte.
Lorsque vous envoyez plusieurs objets à ConvertTo-Html, Windows PowerShell crée la table (ou la liste) en fonction des propriétés du premier objet que vous envoyez. Si les autres objets ne possèdent pas l'une des propriétés spécifiées, la valeur de propriété de cet objet est une cellule vide. Si les autres objets ont des propriétés supplémentaires, ces valeurs de propriété ne sont pas incluses dans le fichier.
PARAMÈTRES
-As <string>
Détermine si l'objet est mis en forme sous la forme d'une table ou d'une liste. Les valeurs valides sont TABLE et LIST. La valeur par défaut est TABLE.
La valeur TABLE génère une table HTML qui ressemble à la table Windows PowerShell. La ligne d'en-tête affiche le nom des propriétés. Chaque ligne de la table représente un objet et affiche les valeurs de l'objet pour chaque propriété.
La valeur LIST génère une table HTML à deux colonnes pour chaque objet, qui ressemble au format de liste de Windows PowerShell. La première colonne contient le nom de la propriété, tandis que la deuxième affiche sa valeur.
Obligatoire ? false
Position ? named
Valeur par défaut Table
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Body <string[]>
Spécifie le texte à ajouter après la balise <BODY> d'ouverture. Par défaut, aucun texte ne figure à cette position.
Obligatoire ? false
Position ? 4
Valeur par défaut Pas de texte.
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-CssUri <Uri>
Spécifie l'URI (Uniform Resource Identifier) de la feuille de style en cascade (CSS) appliquée au fichier HTML.
L'URI est inclus dans un lien de feuille de style de la sortie.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Fragment [<SwitchParameter>]
Génère uniquement une table HTML. Les balises HTML, HEAD, TITLE et BODY sont omises.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Head <string[]>
Spécifie le contenu de la balise <HEAD>. La valeur par défaut est <title>HTML TABLE</title>. Si vous utilisez
le paramètre Head, le paramètre Title est ignoré.
Obligatoire ? false
Position ? 2
Valeur par défaut <title>HTML TABLE</title>
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <psobject>
Spécifie les objets à représenter au format HTML. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
Si vous utilisez ce paramètre pour envoyer plusieurs objets, tels que tous les services d'un ordinateur, ConvertTo-Html crée une table qui affiche les propriétés d'une collection ou d'une table d'objets (System.Object []).
Pour créer une table d'objets individuels, utilisez l'opérateur de pipeline pour diriger les objets vers ConvertTo-Html.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? false
-PostContent <string[]>
Spécifie le texte à ajouter après la balise </TABLE> de fermeture. Par défaut, aucun texte ne figure à cette position.
Obligatoire ? false
Position ? named
Valeur par défaut Pas de texte
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-PreContent <string[]>
Spécifie le texte à ajouter avant la balise <TABLE> d'ouverture. Par défaut, aucun texte ne figure à cette position.
Obligatoire ? false
Position ? named
Valeur par défaut Pas de texte
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Property <Object[]>
Inclut les propriétés spécifiées des objets dans le document HTML.
Obligatoire ? false
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Title <string>
Spécifie un titre pour le fichier HTML, à savoir le texte qui apparaît entre les balises <TITLE>.
Obligatoire ? false
Position ? 3
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.Management.Automation.PSObject
Vous pouvez diriger n'importe quel objet .NET vers ConvertTo-Html.
SORTIES
System.String
ConvertTo-Html retourne une série de chaînes composées de code HTML valide.
NOTES
Pour utiliser cette applet de commande, dirigez un ou plusieurs objets vers l'applet de commande ou utilisez le paramètre InputObject pour spécifier l'objet. Lorsque l'entrée consiste en plusieurs objets, la sortie de ces deux méthodes est assez différente.
-- Lorsque vous dirigez plusieurs objets vers une applet de commande, Windows PowerShell envoie ces objets un par un. En conséquence, ConvertTo-Html crée une table qui affiche les objets individuels. Par exemple, si vous dirigez les processus d'un ordinateur vers ConvertTo-Html, la table générée affiche tous les processus.
-- Lorsque vous utilisez le paramètre InputObject pour envoyer plusieurs objets, ConvertTo-Html reçoit ces objets sous la forme d'une collection ou d'un tableau. En conséquence, elle crée une table qui affiche le tableau et ses propriétés, et non pas les éléments du tableau. Par exemple, si vous utilisez InputObject pour envoyer les processus d'un ordinateur à ConvertTo-Html, la table obtenue affiche un tableau d'objets (System.Object[]) et ses propriétés.
Pour se conformer à la DTD stricte du format XHTML, la balise DOCTYPE est modifiée en conséquence :
(<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)
-------------------------- EXEMPLE 1 --------------------------
C:\PS>convertto-html -inputobject (get-date)
Description
-----------
Cette commande crée une page HTML qui affiche les propriétés de la date actuelle. Elle utilise le paramètre InputObject pour envoyer les résultats d'une commande Get-Date à l'applet de commande ConvertTo-Html.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>get-alias | convertto-html > aliases.htm
C:\PS> invoke-item aliases.htm
Description
-----------
Cette commande crée une page HTML qui répertorie les alias Windows PowerShell de la console actuelle.
Elle utilise l'applet de commande Get-Alias pour obtenir les alias. Elle utilise l'opérateur de pipeline (|) pour envoyer les alias à l'applet de commande ConvertTo-Html, qui crée la page HTML.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>get-eventlog -logname "Windows PowerShell | convertto-html > pslog.htm
Description
-----------
Cette commande crée une page HTML appelée pslog.htm qui affiche les événements du journal d'événements Windows PowerShell de l'ordinateur local.
Elle utilise l'applet de commande Get-EventLog pour obtenir les événements du journal Windows PowerShell, puis se sert de l'opérateur de pipeline (|) pour envoyer les événements à l'applet de commande ConvertTo-Html.
La commande utilise également l'opérateur de redirection (>) pour envoyer le code HTML au fichier pslog.htm.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>get-process | convertto-html -property Name, Path, Company -title "Process Information" > proc.htm; ii proc.htm
Description
-----------
Ces commandes créent et ouvrent une page HTML qui répertorie le nom, le chemin d'accès et la société des processus de l'ordinateur local.
La première commande utilise l'applet de commande Get-Process pour obtenir les objets représentant les processus exécutés sur l'ordinateur. Elle utilise l'opérateur de pipeline (|) pour envoyer les objets processus à l'applet de commande ConvertTo-Html.
La commande utilise le paramètre Property pour sélectionner trois propriétés des objets processus à inclure dans la table. Elle utilise le paramètre Title pour spécifier le titre de la page HTML. Elle utilise également l'opérateur de redirection (>) pour envoyer le contenu HTML obtenu vers un fichier intitulé Proc.htm.
La deuxième commande utilise l'applet de commande Invoke-Item (alias = ii) pour ouvrir le fichier Proc.htm dans le navigateur par défaut. Les deux commandes sont séparées par un point-virgule (;).
-------------------------- EXEMPLE 5 --------------------------
C:\PS>get-service | convertto-html -CssUri "test.css"
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
...
Description
-----------
Cette commande crée une page HTML avec les objets services retournés par l'applet de commande Get-Service. Elle utilise le paramètre CssUri pour spécifier une feuille de style en cascade pour la page HTML.
Le paramètre CssUri ajoute une balise « <link rel="stylesheet" type="text/css » supplémentaire au contenu HTML obtenu. L'attribut HREF de la balise contient le nom de la feuille de style.
-------------------------- EXEMPLE 6 --------------------------
C:\PS>get-service | convertto-html -as LIST > services.htm
Description
-----------
Cette commande crée une page HTML avec les objets services retournés par l'applet de commande Get-Service. Elle utilise le paramètre As pour spécifier un format de liste. L'opérateur de redirection (>) envoie le contenu HTML généré au fichier Services.htm.
-------------------------- EXEMPLE 7 --------------------------
C:\PS>get-date | cth -fragment
<table>
<colgroup>...</colgroup>
<tr><th>DisplayHint</th><th>DateTime</th><th>Date</th><th>Day</th><th>DayOfWeek</th><th>DayOfYear</th><th>Hour</th>
<th>
Kind</th><th>Millisecond</th><th>Minute</th><th>Month</th><th>Second</th><th>Ticks</th><th>TimeOfDay</th><th>Year</
th><
/tr>
<tr><td>DateTime</td><td>Monday, May 05, 2008 10:40:04 AM</td><td>5/5/2008 12:00:00 AM</td><td>5</td><td>Monday</td
><td
>126</td><td>10</td><td>Local</td><td>123</td><td>40</td><td>5</td><td>4</td><td>633455808041237213</td><td>10:40:0
4.12
37213</td><td>2008</td></tr>
</table>
Description
-----------
Cette commande utilise ConvertTo-Html pour générer une table HTML de la date actuelle. Elle utilise l'applet de commande Get-Date pour obtenir la date actuelle. Elle utilise un opérateur de pipeline (|) pour envoyer les résultats à l'applet de commande ConvertTo-Html (alias « cth »).
La commande ConvertTo-Html inclut le paramètre Fragment, qui limite la sortie à une table HTML. En conséquence, les autres éléments d'une page HTML, tels que les balises <HEAD> et <BODY>, sont omis.
-------------------------- EXEMPLE 8 --------------------------
C:\PS>get-eventlog -log "Windows PowerShell" | convertto-html -property id, level, task
Description
-----------
Cette commande utilise l'applet de commande Get-EventLog pour obtenir les événements du journal d'événements Windows PowerShell.
Elle utilise un opérateur de pipeline (|) pour envoyer les événements à l'applet de commande ConvertTo-Html, qui les convertit au format HTML.
La commande ConvertTo-Html utilise le paramètre Property pour sélectionner uniquement les propriétés ID, Level et Task de l'événement.
-------------------------- EXEMPLE 9 --------------------------
C:\PS>get-service A* | ConvertTo-Html -title "Windows Services: Server01" -body (get-date) -pre "<P>Generated by Corporate IT</P>" -post "For details, contact Corporate IT." > services.htm; ii services.htm
Description
-----------
Cette commande crée et ouvre une page Web qui affiche les services de l'ordinateur commençant par la lettre A. Elle utilise les paramètres Title, Body, PreContent et PostContent de ConvertTo-Html pour personnaliser la sortie.
La première partie de la commande utilise l'applet de commande Get-Service pour obtenir les services de l'ordinateur commençant par la lettre A. La commande utilise un opérateur de pipeline (|) pour envoyer les résultats à l'applet de commande ConvertTo-Html. Elle utilise un opérateur de redirection (>) pour envoyer la sortie au fichier Services.htm.
Un point-virgule (;) termine la première commande et en démarre une deuxième, qui utilise l'applet de commande Invoke-Item (alias = ii) pour ouvrir le fichier Services.htm dans le navigateur par défaut.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113290
ConvertTo-CSV
ConvertTo-Xml
ConvertTo-Html
RÉSUMÉ
Convertit des objets Microsoft .NET Framework au format HTML pouvant être affiché dans un navigateur Web.
SYNTAXE
ConvertTo-Html [[-Head] <string[]>] [[-Title] <string>] [[-Body] <string[]>] [-CssUri <Uri>] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]
ConvertTo-Html [-Fragment] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[ ]>] [-PreContent <string[]>] [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertTo-Html convertit des objets .NET Framework au format HTML pouvant être affiché dans un navigateur Web. Vous pouvez utiliser cette applet de commande pour afficher la sortie d'une commande dans une page Web.
Vous pouvez utiliser les paramètres de ConvertTo-Html pour sélectionner des propriétés d'objet, pour spécifier un format de table ou de liste, pour indiquer le titre de la page HTML, pour ajouter du texte avant et après l'objet et pour retourner uniquement un fragment de table ou de liste, au lieu d'une page DTD stricte.
Lorsque vous envoyez plusieurs objets à ConvertTo-Html, Windows PowerShell crée la table (ou la liste) en fonction des propriétés du premier objet que vous envoyez. Si les autres objets ne possèdent pas l'une des propriétés spécifiées, la valeur de propriété de cet objet est une cellule vide. Si les autres objets ont des propriétés supplémentaires, ces valeurs de propriété ne sont pas incluses dans le fichier.
PARAMÈTRES
-As <string>
Détermine si l'objet est mis en forme sous la forme d'une table ou d'une liste. Les valeurs valides sont TABLE et LIST. La valeur par défaut est TABLE.
La valeur TABLE génère une table HTML qui ressemble à la table Windows PowerShell. La ligne d'en-tête affiche le nom des propriétés. Chaque ligne de la table représente un objet et affiche les valeurs de l'objet pour chaque propriété.
La valeur LIST génère une table HTML à deux colonnes pour chaque objet, qui ressemble au format de liste de Windows PowerShell. La première colonne contient le nom de la propriété, tandis que la deuxième affiche sa valeur.
Obligatoire ? false
Position ? named
Valeur par défaut Table
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Body <string[]>
Spécifie le texte à ajouter après la balise <BODY> d'ouverture. Par défaut, aucun texte ne figure à cette position.
Obligatoire ? false
Position ? 4
Valeur par défaut Pas de texte.
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-CssUri <Uri>
Spécifie l'URI (Uniform Resource Identifier) de la feuille de style en cascade (CSS) appliquée au fichier HTML.
L'URI est inclus dans un lien de feuille de style de la sortie.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Fragment [<SwitchParameter>]
Génère uniquement une table HTML. Les balises HTML, HEAD, TITLE et BODY sont omises.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Head <string[]>
Spécifie le contenu de la balise <HEAD>. La valeur par défaut est <title>HTML TABLE</title>. Si vous utilisez
le paramètre Head, le paramètre Title est ignoré.
Obligatoire ? false
Position ? 2
Valeur par défaut <title>HTML TABLE</title>
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-InputObject <psobject>
Spécifie les objets à représenter au format HTML. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
Si vous utilisez ce paramètre pour envoyer plusieurs objets, tels que tous les services d'un ordinateur, ConvertTo-Html crée une table qui affiche les propriétés d'une collection ou d'une table d'objets (System.Object []).
Pour créer une table d'objets individuels, utilisez l'opérateur de pipeline pour diriger les objets vers ConvertTo-Html.
Obligatoire ? false
Position ? named
Valeur par défaut
Accepter l'entrée de pipeline ? true (ByValue)
Accepter les caractères génériques ? false
-PostContent <string[]>
Spécifie le texte à ajouter après la balise </TABLE> de fermeture. Par défaut, aucun texte ne figure à cette position.
Obligatoire ? false
Position ? named
Valeur par défaut Pas de texte
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-PreContent <string[]>
Spécifie le texte à ajouter avant la balise <TABLE> d'ouverture. Par défaut, aucun texte ne figure à cette position.
Obligatoire ? false
Position ? named
Valeur par défaut Pas de texte
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Property <Object[]>
Inclut les propriétés spécifiées des objets dans le document HTML.
Obligatoire ? false
Position ? 1
Valeur par défaut
Accepter l'entrée de pipeline ? false
Accepter les caractères génériques ? false
-Title <string>
Spécifie un titre pour le fichier HTML, à savoir le texte qui apparaît entre les balises <TITLE>.
Obligatoire ? false
Position ? 3
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.Management.Automation.PSObject
Vous pouvez diriger n'importe quel objet .NET vers ConvertTo-Html.
SORTIES
System.String
ConvertTo-Html retourne une série de chaînes composées de code HTML valide.
NOTES
Pour utiliser cette applet de commande, dirigez un ou plusieurs objets vers l'applet de commande ou utilisez le paramètre InputObject pour spécifier l'objet. Lorsque l'entrée consiste en plusieurs objets, la sortie de ces deux méthodes est assez différente.
-- Lorsque vous dirigez plusieurs objets vers une applet de commande, Windows PowerShell envoie ces objets un par un. En conséquence, ConvertTo-Html crée une table qui affiche les objets individuels. Par exemple, si vous dirigez les processus d'un ordinateur vers ConvertTo-Html, la table générée affiche tous les processus.
-- Lorsque vous utilisez le paramètre InputObject pour envoyer plusieurs objets, ConvertTo-Html reçoit ces objets sous la forme d'une collection ou d'un tableau. En conséquence, elle crée une table qui affiche le tableau et ses propriétés, et non pas les éléments du tableau. Par exemple, si vous utilisez InputObject pour envoyer les processus d'un ordinateur à ConvertTo-Html, la table obtenue affiche un tableau d'objets (System.Object[]) et ses propriétés.
Pour se conformer à la DTD stricte du format XHTML, la balise DOCTYPE est modifiée en conséquence :
(<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)
-------------------------- EXEMPLE 1 --------------------------
C:\PS>convertto-html -inputobject (get-date)
Description
-----------
Cette commande crée une page HTML qui affiche les propriétés de la date actuelle. Elle utilise le paramètre InputObject pour envoyer les résultats d'une commande Get-Date à l'applet de commande ConvertTo-Html.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>get-alias | convertto-html > aliases.htm
C:\PS> invoke-item aliases.htm
Description
-----------
Cette commande crée une page HTML qui répertorie les alias Windows PowerShell de la console actuelle.
Elle utilise l'applet de commande Get-Alias pour obtenir les alias. Elle utilise l'opérateur de pipeline (|) pour envoyer les alias à l'applet de commande ConvertTo-Html, qui crée la page HTML.
-------------------------- EXEMPLE 3 --------------------------
C:\PS>get-eventlog -logname "Windows PowerShell | convertto-html > pslog.htm
Description
-----------
Cette commande crée une page HTML appelée pslog.htm qui affiche les événements du journal d'événements Windows PowerShell de l'ordinateur local.
Elle utilise l'applet de commande Get-EventLog pour obtenir les événements du journal Windows PowerShell, puis se sert de l'opérateur de pipeline (|) pour envoyer les événements à l'applet de commande ConvertTo-Html.
La commande utilise également l'opérateur de redirection (>) pour envoyer le code HTML au fichier pslog.htm.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>get-process | convertto-html -property Name, Path, Company -title "Process Information" > proc.htm; ii proc.htm
Description
-----------
Ces commandes créent et ouvrent une page HTML qui répertorie le nom, le chemin d'accès et la société des processus de l'ordinateur local.
La première commande utilise l'applet de commande Get-Process pour obtenir les objets représentant les processus exécutés sur l'ordinateur. Elle utilise l'opérateur de pipeline (|) pour envoyer les objets processus à l'applet de commande ConvertTo-Html.
La commande utilise le paramètre Property pour sélectionner trois propriétés des objets processus à inclure dans la table. Elle utilise le paramètre Title pour spécifier le titre de la page HTML. Elle utilise également l'opérateur de redirection (>) pour envoyer le contenu HTML obtenu vers un fichier intitulé Proc.htm.
La deuxième commande utilise l'applet de commande Invoke-Item (alias = ii) pour ouvrir le fichier Proc.htm dans le navigateur par défaut. Les deux commandes sont séparées par un point-virgule (;).
-------------------------- EXEMPLE 5 --------------------------
C:\PS>get-service | convertto-html -CssUri "test.css"
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
...
Description
-----------
Cette commande crée une page HTML avec les objets services retournés par l'applet de commande Get-Service. Elle utilise le paramètre CssUri pour spécifier une feuille de style en cascade pour la page HTML.
Le paramètre CssUri ajoute une balise « <link rel="stylesheet" type="text/css » supplémentaire au contenu HTML obtenu. L'attribut HREF de la balise contient le nom de la feuille de style.
-------------------------- EXEMPLE 6 --------------------------
C:\PS>get-service | convertto-html -as LIST > services.htm
Description
-----------
Cette commande crée une page HTML avec les objets services retournés par l'applet de commande Get-Service. Elle utilise le paramètre As pour spécifier un format de liste. L'opérateur de redirection (>) envoie le contenu HTML généré au fichier Services.htm.
-------------------------- EXEMPLE 7 --------------------------
C:\PS>get-date | cth -fragment
<table>
<colgroup>...</colgroup>
<tr><th>DisplayHint</th><th>DateTime</th><th>Date</th><th>Day</th><th>DayOfWeek</th><th>DayOfYear</th><th>Hour</th>
<th>
Kind</th><th>Millisecond</th><th>Minute</th><th>Month</th><th>Second</th><th>Ticks</th><th>TimeOfDay</th><th>Year</
th><
/tr>
<tr><td>DateTime</td><td>Monday, May 05, 2008 10:40:04 AM</td><td>5/5/2008 12:00:00 AM</td><td>5</td><td>Monday</td
><td
>126</td><td>10</td><td>Local</td><td>123</td><td>40</td><td>5</td><td>4</td><td>633455808041237213</td><td>10:40:0
4.12
37213</td><td>2008</td></tr>
</table>
Description
-----------
Cette commande utilise ConvertTo-Html pour générer une table HTML de la date actuelle. Elle utilise l'applet de commande Get-Date pour obtenir la date actuelle. Elle utilise un opérateur de pipeline (|) pour envoyer les résultats à l'applet de commande ConvertTo-Html (alias « cth »).
La commande ConvertTo-Html inclut le paramètre Fragment, qui limite la sortie à une table HTML. En conséquence, les autres éléments d'une page HTML, tels que les balises <HEAD> et <BODY>, sont omis.
-------------------------- EXEMPLE 8 --------------------------
C:\PS>get-eventlog -log "Windows PowerShell" | convertto-html -property id, level, task
Description
-----------
Cette commande utilise l'applet de commande Get-EventLog pour obtenir les événements du journal d'événements Windows PowerShell.
Elle utilise un opérateur de pipeline (|) pour envoyer les événements à l'applet de commande ConvertTo-Html, qui les convertit au format HTML.
La commande ConvertTo-Html utilise le paramètre Property pour sélectionner uniquement les propriétés ID, Level et Task de l'événement.
-------------------------- EXEMPLE 9 --------------------------
C:\PS>get-service A* | ConvertTo-Html -title "Windows Services: Server01" -body (get-date) -pre "<P>Generated by Corporate IT</P>" -post "For details, contact Corporate IT." > services.htm; ii services.htm
Description
-----------
Cette commande crée et ouvre une page Web qui affiche les services de l'ordinateur commençant par la lettre A. Elle utilise les paramètres Title, Body, PreContent et PostContent de ConvertTo-Html pour personnaliser la sortie.
La première partie de la commande utilise l'applet de commande Get-Service pour obtenir les services de l'ordinateur commençant par la lettre A. La commande utilise un opérateur de pipeline (|) pour envoyer les résultats à l'applet de commande ConvertTo-Html. Elle utilise un opérateur de redirection (>) pour envoyer la sortie au fichier Services.htm.
Un point-virgule (;) termine la première commande et en démarre une deuxième, qui utilise l'applet de commande Invoke-Item (alias = ii) pour ouvrir le fichier Services.htm dans le navigateur par défaut.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113290
ConvertTo-CSV
ConvertTo-Xml
Convert-Path
NOM
Convert-Path
RÉSUMÉ
Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur Windows PowerShell.
SYNTAXE
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>]
Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Convert-Path convertit un chemin d'accès Windows PowerShell en chemin d'accès de fournisseur Windows PowerShell.
PARAMÈTRES
-LiteralPath <string[]>
Spécifie le chemin d'accès à convertir. La valeur du paramètre LiteralPath est utilisée exactement comme elle est tapée. 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 Windows PowerShell à convertir.
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
-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 un chemin d'accès (mais pas un chemin d'accès littéral) vers Convert-Path.
SORTIES
System.String
Convert-Path retourne une chaîne qui contient le chemin d'accès converti.
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 Convert-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>convert-path ~
Description
-----------
Cette commande développe le répertoire de travail actif.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>convert-path HKLM:\software\microsoft
Description
-----------
Cette commande convertit le chemin d'accès au fournisseur Windows PowerShell en chemin d'accès standard au Registre
.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113289
about_Providers
Test-Path
Split-Path
Resolve-Path
Join-Path
Convert-Path
RÉSUMÉ
Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur Windows PowerShell.
SYNTAXE
Convert-Path [-LiteralPath] <string[]> [-UseTransaction] [<CommonParameters>]
Convert-Path [-Path] <string[]> [-UseTransaction] [<CommonParameters>]
DESCRIPTION
L'applet de commande Convert-Path convertit un chemin d'accès Windows PowerShell en chemin d'accès de fournisseur Windows PowerShell.
PARAMÈTRES
-LiteralPath <string[]>
Spécifie le chemin d'accès à convertir. La valeur du paramètre LiteralPath est utilisée exactement comme elle est tapée. 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 Windows PowerShell à convertir.
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
-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 un chemin d'accès (mais pas un chemin d'accès littéral) vers Convert-Path.
SORTIES
System.String
Convert-Path retourne une chaîne qui contient le chemin d'accès converti.
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 Convert-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>convert-path ~
Description
-----------
Cette commande développe le répertoire de travail actif.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>convert-path HKLM:\software\microsoft
Description
-----------
Cette commande convertit le chemin d'accès au fournisseur Windows PowerShell en chemin d'accès standard au Registre
.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113289
about_Providers
Test-Path
Split-Path
Resolve-Path
Join-Path
ConvertFrom-StringData
NOM
ConvertFrom-StringData
RÉSUMÉ
Convertit une chaîne contenant une ou plusieurs paires clé/valeur en une table de hachage.
SYNTAXE
ConvertFrom-StringData [-StringData] <string> [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertFrom-StringData convertit une chaîne contenant une ou plusieurs paires clé/valeur en une table de hachage. Étant donné que chaque paire clé/valeur doit figurer sur une ligne distincte, des chaînes here-string sont souvent utilisées comme format d'entrée.
L'applet de commande ConvertFrom-StringData est considérée une applet de commande sécurisée qui peut être utilisée dans la section DATA d'un script ou d'une fonction. Si vous l'utilisez dans une section DATA, le contenu de la chaîne doit se conformer aux règles de cette section DATA. Pour plus d'informations, consultez about_Data_Sections.
PARAMÈTRES
-StringData <string>
Spécifie la chaîne à convertir. Vous pouvez utiliser ce paramètre ou diriger une chaîne vers ConvertFrom-StringData. Le nom de paramètre est facultatif.
La valeur de ce paramètre doit être une chaîne entourée de guillemets simples (chaîne entre guillemets simples), une chaîne entourée de guillemets doubles (chaîne entre guillemets doubles) ou une chaîne here-string contenant une ou plusieurs paires clé/valeur. Chaque paire clé/valeur doit figurer sur une ligne distincte ou être séparée par des caractères de nouvelle ligne (`n).
Vous pouvez inclure des commentaires dans la chaîne, mais ils ne peuvent pas figurer sur la même ligne qu'une paire clé/valeur. Les commentaires ne sont pas inclus dans la table de hachage.
Une chaîne here-string est une chaîne constituée d'une ou plusieurs lignes au sein desquelles les guillemets sont interprétés littéralement. Pour plus d'informations, consultez about_Quoting_Rules.
Obligatoire ? true
Position ? 1
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.String
Vous pouvez diriger une chaîne contenant une paire clé/valeur vers ConvertFrom-StringData.
SORTIES
System.Collections.Hashtable
ConvertFrom-StringData retourne une table de hachage créée à partir des paires clé/valeur.
NOTES
Une chaîne here-string est une chaîne constituée d'une ou plusieurs lignes au sein desquelles les guillemets sont interprétés littéralement. Pour plus d'informations, consultez about_Quoting_Rules.
ConvertFrom-StringData peut être utile dans les scripts affichant des messages utilisateur dans plusieurs langues. Vous pouvez utiliser les tables de hachage de style dictionnaire pour isoler des chaînes de texte du code, par exemple dans les fichiers de ressources, puis mettre en forme ces chaînes de texte pour une utilisation dans des outils de traduction.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>$here = @'
Msg1 = The string parameter is required.
Msg2 = Credentials are required for this command.
Msg3 = The specified variable does not exist.
'@
C:\PS> convertfrom-stringdata -stringdata $here
Name Value
---- -----
Msg3 The specified variable does not exist.
Msg2 Credentials are required for this command.
Msg1 The string parameter is required.
Description
-----------
Ces commandes convertissent une chaîne here-string entre guillemets simples de messages utilisateur en une table de hachage. Dans une chaîne entre guillemets simples, les valeurs ne sont pas substituées aux variables et les expressions ne sont pas évaluées.
La première commande crée une chaîne here-string et l'enregistre dans la variable $here.
La deuxième commande utilise l'applet de commande ConvertFrom-StringData pour convertir la chaîne here-string de la variable $here en une table de hachage.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>$p = @"
ISE = Windows PowerShell Integrated Scripting Environment
"@
C:\PS> $p | get-member
TypeName: System.String
Name MemberType Definition
---- ---------- ----------
Clone Method System.Object Clone()
...
C:\PS> $hash = convertfrom-stringdata -stringdata $p
C:\PS> $hash | get-member
TypeName: System.Collections.Hashtable
Name MemberType Definition
---- ---------- ----------
Add Method System.Void Add(Object key, Object
...
Description
-----------
Ces commandes montrent que ConvertFrom-StringData convertit réellement une chaîne here-string en une table de hachage.
La première commande crée une chaîne here-string entre guillemets doubles qui inclut une paire clé/valeur et l'enregistre dans la variable $p.
La deuxième commande utilise un opérateur de pipeline (|) pour envoyer la variable $p à l'applet de commande Get-Member. Le résultat indique que $p est une chaîne (System.String).
La troisième commande utilise l'applet de commande ConvertFrom-StringData pour convertir la chaîne here-string de la variable $p en une table de hachage. La commande stocke le résultat dans la variable $hash.
La dernière commande utilise un opérateur de pipeline (|) pour envoyer la variable $hash à l'applet de commande Get-Member. Le résultat montre que le contenu de la variable $hash est une table de hachage (System.Collections.Hashtable).
-------------------------- EXEMPLE 3 --------------------------
C:\PS>convertfrom-stringdata -stringdata @'
Name = Disks.ps1
# Category is optional.
Category = Storage
Cost = Free
'@
Name Value
---- -----
Cost Free
Category Storage
Name Disks.ps1
Description
-----------
Cette commande convertit une chaîne here-string entre guillemets simples qui contient des paires clé/valeur en une table de hachage.
Dans cette commande, la valeur du paramètre StringData est une chaîne here-string, au lieu d'une variable contenant une chaîne here-string. L'un et l'autre format sont valides.
La chaîne here-string inclut un commentaire sur l'une des chaînes. Il est possible d'insérer des commentaires dans les chaînes, pourvu qu'ils ne figurent pas sur la même ligne qu'une paire clé/valeur.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>$a = convertfrom-stringdata -stringdata "Top = Red `n Bottom = Blue"
C:\PS> "Top = " + $a.Top
Top = Red
C:\PS> "Bottom = " + $a.Bottom
Bottom = Blue
Description
-----------
Cet exemple convertit une chaîne entre guillemets doubles normale (pas une chaîne here-string) en une table de hachage et l'enregistre dans la variable $a.
Pour satisfaire la condition selon laquelle chaque paire clé/valeur doit figurer sur une ligne distincte, il utilise le caractère de nouvelle ligne Windows PowerShell (`n) pour séparer les paires.
Le résultat est une table de hachage de l'entrée. Les autres commandes affichent la sortie.
-------------------------- EXEMPLE 5 --------------------------
C:\PS>$TextMsgs = DATA {
ConvertFrom-StringData @'
Text001 = The $Notebook variable contains the name of the user's system notebook.
Text002 = The $MyNotebook variable contains the name of the user's private notebook.
'@
}
C:\PS> $TextMsgs.Text001
The $Notebook variable contains the name of the user's system notebook.
C:\PS> $TextMsgs.Text002
The $MyNotebook variable contains the name of the user's private notebook.
Description
-----------
Cet exemple affiche une commande ConvertFrom-StringData utilisée dans la section DATA d'un script. Les instructions au-dessous de la section DATA affichent le texte à l'utilisateur.
Étant donné que le texte inclut des noms de variables, il doit être entouré d'une chaîne entre guillemets simples afin que les variables soient interprétées littéralement, et non pas développées. Les variables ne sont pas autorisées dans la section DATA.
-------------------------- EXEMPLE 6 --------------------------
C:\PS>$here = @'
Msg1 = The string parameter is required.
Msg2 = Credentials are required for this command.
Msg3 = The specified variable does not exist.
'@
C:\PS> $hash = $here | convertfrom-stringdata
C:\PS> $hash
Name Value
---- -----
Msg3 The specified variable does not exist.
Msg2 Credentials are required for this command.
Msg1 The string parameter is required.
Description
-----------
Cet exemple montre que vous pouvez utiliser un opérateur de pipeline (|) pour envoyer une chaîne à l'applet de commande ConvertFrom-StringData.
La première commande enregistre une chaîne here-string dans la variable $here. La deuxième commande utilise un opérateur de pipeline (|) pour envoyer la variable $here à l'applet de commande ConvertFrom-StringData. La commande enregistre le résultat dans la variable $hash.
La dernière commande affiche le contenu de la variable $hash.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113288
about_Data_Sections
about_Quoting_Rules
about_Script_Internationalization
ConvertFrom-StringData
RÉSUMÉ
Convertit une chaîne contenant une ou plusieurs paires clé/valeur en une table de hachage.
SYNTAXE
ConvertFrom-StringData [-StringData] <string> [<CommonParameters>]
DESCRIPTION
L'applet de commande ConvertFrom-StringData convertit une chaîne contenant une ou plusieurs paires clé/valeur en une table de hachage. Étant donné que chaque paire clé/valeur doit figurer sur une ligne distincte, des chaînes here-string sont souvent utilisées comme format d'entrée.
L'applet de commande ConvertFrom-StringData est considérée une applet de commande sécurisée qui peut être utilisée dans la section DATA d'un script ou d'une fonction. Si vous l'utilisez dans une section DATA, le contenu de la chaîne doit se conformer aux règles de cette section DATA. Pour plus d'informations, consultez about_Data_Sections.
PARAMÈTRES
-StringData <string>
Spécifie la chaîne à convertir. Vous pouvez utiliser ce paramètre ou diriger une chaîne vers ConvertFrom-StringData. Le nom de paramètre est facultatif.
La valeur de ce paramètre doit être une chaîne entourée de guillemets simples (chaîne entre guillemets simples), une chaîne entourée de guillemets doubles (chaîne entre guillemets doubles) ou une chaîne here-string contenant une ou plusieurs paires clé/valeur. Chaque paire clé/valeur doit figurer sur une ligne distincte ou être séparée par des caractères de nouvelle ligne (`n).
Vous pouvez inclure des commentaires dans la chaîne, mais ils ne peuvent pas figurer sur la même ligne qu'une paire clé/valeur. Les commentaires ne sont pas inclus dans la table de hachage.
Une chaîne here-string est une chaîne constituée d'une ou plusieurs lignes au sein desquelles les guillemets sont interprétés littéralement. Pour plus d'informations, consultez about_Quoting_Rules.
Obligatoire ? true
Position ? 1
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.String
Vous pouvez diriger une chaîne contenant une paire clé/valeur vers ConvertFrom-StringData.
SORTIES
System.Collections.Hashtable
ConvertFrom-StringData retourne une table de hachage créée à partir des paires clé/valeur.
NOTES
Une chaîne here-string est une chaîne constituée d'une ou plusieurs lignes au sein desquelles les guillemets sont interprétés littéralement. Pour plus d'informations, consultez about_Quoting_Rules.
ConvertFrom-StringData peut être utile dans les scripts affichant des messages utilisateur dans plusieurs langues. Vous pouvez utiliser les tables de hachage de style dictionnaire pour isoler des chaînes de texte du code, par exemple dans les fichiers de ressources, puis mettre en forme ces chaînes de texte pour une utilisation dans des outils de traduction.
-------------------------- EXEMPLE 1 --------------------------
C:\PS>$here = @'
Msg1 = The string parameter is required.
Msg2 = Credentials are required for this command.
Msg3 = The specified variable does not exist.
'@
C:\PS> convertfrom-stringdata -stringdata $here
Name Value
---- -----
Msg3 The specified variable does not exist.
Msg2 Credentials are required for this command.
Msg1 The string parameter is required.
Description
-----------
Ces commandes convertissent une chaîne here-string entre guillemets simples de messages utilisateur en une table de hachage. Dans une chaîne entre guillemets simples, les valeurs ne sont pas substituées aux variables et les expressions ne sont pas évaluées.
La première commande crée une chaîne here-string et l'enregistre dans la variable $here.
La deuxième commande utilise l'applet de commande ConvertFrom-StringData pour convertir la chaîne here-string de la variable $here en une table de hachage.
-------------------------- EXEMPLE 2 --------------------------
C:\PS>$p = @"
ISE = Windows PowerShell Integrated Scripting Environment
"@
C:\PS> $p | get-member
TypeName: System.String
Name MemberType Definition
---- ---------- ----------
Clone Method System.Object Clone()
...
C:\PS> $hash = convertfrom-stringdata -stringdata $p
C:\PS> $hash | get-member
TypeName: System.Collections.Hashtable
Name MemberType Definition
---- ---------- ----------
Add Method System.Void Add(Object key, Object
...
Description
-----------
Ces commandes montrent que ConvertFrom-StringData convertit réellement une chaîne here-string en une table de hachage.
La première commande crée une chaîne here-string entre guillemets doubles qui inclut une paire clé/valeur et l'enregistre dans la variable $p.
La deuxième commande utilise un opérateur de pipeline (|) pour envoyer la variable $p à l'applet de commande Get-Member. Le résultat indique que $p est une chaîne (System.String).
La troisième commande utilise l'applet de commande ConvertFrom-StringData pour convertir la chaîne here-string de la variable $p en une table de hachage. La commande stocke le résultat dans la variable $hash.
La dernière commande utilise un opérateur de pipeline (|) pour envoyer la variable $hash à l'applet de commande Get-Member. Le résultat montre que le contenu de la variable $hash est une table de hachage (System.Collections.Hashtable).
-------------------------- EXEMPLE 3 --------------------------
C:\PS>convertfrom-stringdata -stringdata @'
Name = Disks.ps1
# Category is optional.
Category = Storage
Cost = Free
'@
Name Value
---- -----
Cost Free
Category Storage
Name Disks.ps1
Description
-----------
Cette commande convertit une chaîne here-string entre guillemets simples qui contient des paires clé/valeur en une table de hachage.
Dans cette commande, la valeur du paramètre StringData est une chaîne here-string, au lieu d'une variable contenant une chaîne here-string. L'un et l'autre format sont valides.
La chaîne here-string inclut un commentaire sur l'une des chaînes. Il est possible d'insérer des commentaires dans les chaînes, pourvu qu'ils ne figurent pas sur la même ligne qu'une paire clé/valeur.
-------------------------- EXEMPLE 4 --------------------------
C:\PS>$a = convertfrom-stringdata -stringdata "Top = Red `n Bottom = Blue"
C:\PS> "Top = " + $a.Top
Top = Red
C:\PS> "Bottom = " + $a.Bottom
Bottom = Blue
Description
-----------
Cet exemple convertit une chaîne entre guillemets doubles normale (pas une chaîne here-string) en une table de hachage et l'enregistre dans la variable $a.
Pour satisfaire la condition selon laquelle chaque paire clé/valeur doit figurer sur une ligne distincte, il utilise le caractère de nouvelle ligne Windows PowerShell (`n) pour séparer les paires.
Le résultat est une table de hachage de l'entrée. Les autres commandes affichent la sortie.
-------------------------- EXEMPLE 5 --------------------------
C:\PS>$TextMsgs = DATA {
ConvertFrom-StringData @'
Text001 = The $Notebook variable contains the name of the user's system notebook.
Text002 = The $MyNotebook variable contains the name of the user's private notebook.
'@
}
C:\PS> $TextMsgs.Text001
The $Notebook variable contains the name of the user's system notebook.
C:\PS> $TextMsgs.Text002
The $MyNotebook variable contains the name of the user's private notebook.
Description
-----------
Cet exemple affiche une commande ConvertFrom-StringData utilisée dans la section DATA d'un script. Les instructions au-dessous de la section DATA affichent le texte à l'utilisateur.
Étant donné que le texte inclut des noms de variables, il doit être entouré d'une chaîne entre guillemets simples afin que les variables soient interprétées littéralement, et non pas développées. Les variables ne sont pas autorisées dans la section DATA.
-------------------------- EXEMPLE 6 --------------------------
C:\PS>$here = @'
Msg1 = The string parameter is required.
Msg2 = Credentials are required for this command.
Msg3 = The specified variable does not exist.
'@
C:\PS> $hash = $here | convertfrom-stringdata
C:\PS> $hash
Name Value
---- -----
Msg3 The specified variable does not exist.
Msg2 Credentials are required for this command.
Msg1 The string parameter is required.
Description
-----------
Cet exemple montre que vous pouvez utiliser un opérateur de pipeline (|) pour envoyer une chaîne à l'applet de commande ConvertFrom-StringData.
La première commande enregistre une chaîne here-string dans la variable $here. La deuxième commande utilise un opérateur de pipeline (|) pour envoyer la variable $here à l'applet de commande ConvertFrom-StringData. La commande enregistre le résultat dans la variable $hash.
La dernière commande affiche le contenu de la variable $hash.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113288
about_Data_Sections
about_Quoting_Rules
about_Script_Internationalization
Inscription à :
Articles (Atom)