ConvertFrom-String
Extrait et analyse les propriétés structurées à partir du contenu de chaîne.
Syntaxe
ConvertFrom-String
[-Delimiter <String>]
[-PropertyNames <String[]>]
[-InputObject] <String>
[<CommonParameters>]
ConvertFrom-String
[-TemplateFile <String[]>]
[-TemplateContent <String[]>]
[-IncludeExtent]
[-UpdateTemplate]
[-InputObject] <String>
[<CommonParameters>]
Description
L’applet ConvertFrom-String
de commande extrait et analyse les propriétés structurées à partir du contenu de chaîne. Cette applet de commande génère un objet en analysant du texte à partir d’un flux de texte traditionnel. Pour chaque chaîne du pipeline, l’applet de commande fractionne l’entrée par un délimiteur ou une expression d’analyse, puis affecte des noms de propriétés à chacun des éléments fractionnés résultants. Vous pouvez fournir ces noms de propriétés ; si ce n’est pas le cas, ils sont générés automatiquement pour vous.
Le jeu de paramètres par défaut de l’applet de commande, ByDelimiter, fractionne exactement le délimiteur d’expression régulière. Il n’effectue pas de correspondance de guillemets ou d’échappement délimiteur comme l’applet Import-Csv
de commande.
L’ensemble de paramètres de remplacement de l’applet de commande, TemplateParsing, génère des éléments à partir des groupes capturés par une expression régulière. Pour plus d’informations sur les expressions régulières, consultez about_Regular_Expressions.
Cette applet de commande prend en charge deux modes : l’analyse délimitée de base et l’analyse générée automatiquement, pilotée par des exemples.
Par défaut, l’analyse délimitée fractionne l’entrée au niveau de l’espace blanc et elle affecte des noms de propriétés aux groupes résultants.
Vous pouvez personnaliser le délimiteur en pipant les ConvertFrom-String
résultats dans l’une des applets de Format-*
commande, ou vous pouvez utiliser le paramètre Délimiteur .
L’applet de commande prend également en charge l’analyse générée automatiquement par exemple basée sur FlashExtract , le travail de recherche de Microsoft Research.
Exemples
Exemple 1 : Générer un objet avec des noms de propriétés par défaut
"Hello World" | ConvertFrom-String
P1 P2
-- --
Hello World
Cette commande génère un objet avec des noms de propriétés par défaut, P1 et P2.
Exemple 1A : Connaître l’objet généré
Cette commande génère un objet avec les propriétés P1, P2 ; les deux propriétés sont de type String , par défaut.
"Hello World" | ConvertFrom-String | Get-Member
TypeName: System.Management.Automation.PSCustomObject
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
P1 NoteProperty string P1=Hello
P2 NoteProperty string P2=World
Exemple 2 : Générer un objet avec des noms de propriétés par défaut à l’aide d’un délimiteur
Cette commande génère un objet avec un domaine et un nom d’utilisateur à l’aide de la barre oblique inverse (\
) comme délimiteur. Le caractère de barre oblique inverse doit être échappé avec une autre barre oblique inverse lors de l’utilisation d’expressions régulières.
"Contoso\Administrator" | ConvertFrom-String -Delimiter "\\"
P1 P2
-- --
Contoso Administrator
Exemple 3 : Générer un objet qui contient deux propriétés nommées
L’exemple suivant crée des objets à partir d’entrées de fichier hôtes Windows.
$content = Get-Content C:\Windows\System32\drivers\etc\hosts
$content = $content -match "^[^#]"
$content | ConvertFrom-String -PropertyNames IP, Server
IP Server
-- ------
192.168.7.10 W2012R2
192.168.7.20 W2016
192.168.7.101 WIN8
192.168.7.102 WIN10
L’applet Get-Content
de commande stocke le contenu d’un fichier hôtes Windows dans $content
. La deuxième commande supprime tous les commentaires au début du fichier hosts à l’aide d’une expression régulière qui correspond à une ligne qui ne commence pas par (#
). La dernière commande convertit le texte restant en objets avec les propriétés Serveur et IP .
Exemple 4 : Utilisez une expression comme valeur du paramètre TemplateContent, enregistrez les résultats dans une variable.
Cette commande utilise une expression comme valeur du paramètre TemplateContent . L’expression est enregistrée dans une variable par souci de simplicité. Windows PowerShell comprend maintenant que la chaîne utilisée sur le pipeline comporte ConvertFrom-String
trois propriétés :
- Nom
- Téléphone
- âge
$template = @'
{Name*:Phoebe Cat}, {phone:425-123-6789}, {age:6}
{Name*:Lucky Shot}, {phone:(206) 987-4321}, {age:12}
'@
$testText = @'
Phoebe Cat, 425-123-6789, 6
Lucky Shot, (206) 987-4321, 12
Elephant Wise, 425-888-7766, 87
Wild Shrimp, (111) 222-3333, 1
'@
$PersonalData = $testText | ConvertFrom-String -TemplateContent $template
Write-output ("Pet items found: " + ($PersonalData.Count))
$PersonalData
Pet items found: 4
Name phone age
---- ----- ---
Phoebe Cat 425-123-6789 6
Lucky Shot (206) 987-4321 12
Elephant Wise 425-888-7766 87
Wild Shrimp (111) 222-3333 1
Chaque ligne de l’entrée est évaluée par l’exemple correspond. Si la ligne correspond aux exemples donnés dans le modèle, les valeurs sont extraites et transmises à la variable de sortie.
Les exemples de données, $template
fournissent deux formats téléphoniques différents :
425-123-6789
(206) 987-4321
Les exemples de données fournissent également deux formats d’âge différents :
6
12
Cela implique que les téléphones comme (206) 987 4321
ne seront pas reconnus, car il n’y a pas d’exemple de données qui correspondent à ce modèle, car il n’y a pas de traits d’union.
Exemple 5 : Spécification de types de données aux propriétés générées
Il s’agit du même exemple que l’exemple 4 ci-dessus. La différence est que la chaîne de modèle inclut un type de données pour chaque propriété souhaitée.
$template = @'
{[string]Name*:Phoebe Cat}, {[string]phone:425-123-6789}, {[int]age:6}
{[string]Name*:Lucky Shot}, {[string]phone:(206) 987-4321}, {[int]age:12}
'@
$testText = @'
Phoebe Cat, 425-123-6789, 6
Lucky Shot, (206) 987-4321, 12
Elephant Wise, 425-888-7766, 87
Wild Shrimp, (111) 222-3333, 1
'@
$PersonalData = $testText | ConvertFrom-String -TemplateContent $template
Write-output ("Pet items found: " + ($PersonalData.Count))
$PersonalData
Pet items found: 4
Name phone age
---- ----- ---
Phoebe Cat 425-123-6789 6
Lucky Shot (206) 987-4321 12
Elephant Wise 425-888-7766 87
Wild Shrimp (111) 222-3333 1
$PersonalData | Get-Member
TypeName: System.Management.Automation.PSCustomObject
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
age NoteProperty int age=6
Name NoteProperty string Name=Phoebe Cat
phone NoteProperty string phone=425-123-6789
L’applet Get-Member
de commande est utilisée pour montrer que la propriété age est un entier.
Paramètres
-Delimiter
Spécifie une expression régulière qui identifie la limite entre les éléments. Les éléments créés par le fractionnement deviennent des propriétés dans l’objet résultant. Le délimiteur est finalement utilisé dans un appel à la méthode Split du type [System.Text.RegularExpressions.RegularExpression]
.
Type: | String |
Alias: | DEL |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-IncludeExtent
Indique que cette applet de commande inclut une propriété de texte d’extension supprimée par défaut.
Type: | SwitchParameter |
Alias: | IE |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-InputObject
Spécifie les chaînes reçues du pipeline ou une variable qui contient un objet de chaîne.
Type: | String |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PropertyNames
Spécifie un tableau de noms de propriétés auxquels attribuer des valeurs fractionnées dans l’objet résultant. Chaque ligne de texte que vous fractionnez ou analyse génère des éléments qui représentent des valeurs de propriété. Si l’élément est le résultat d’un groupe de capture et que ce groupe de capture est nommé (par exemple, (?<name>)
ou (?'name')
), le nom de ce groupe de capture est affecté à la propriété.
Si vous fournissez des éléments dans le tableau PropertyName , ces noms sont affectés aux propriétés qui n’ont pas encore été nommées.
Si vous fournissez plus de noms de propriétés qu’il y a de champs, PowerShell ignore les noms de propriétés supplémentaires. Si vous ne spécifiez pas suffisamment de noms de propriétés pour nommer tous les champs, PowerShell affecte automatiquement des noms de propriétés numériques à toutes les propriétés qui ne sont pas nommées : P1, P2, etc.
Type: | String[] |
Alias: | PN |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-TemplateContent
Spécifie une expression, ou une expression enregistrée sous forme de variable, qui décrit les propriétés auxquelles cette applet de commande affecte des chaînes. La syntaxe d’une spécification de champ de modèle est la suivante : {[optional-typecast]<name>:<example-value>}
.
Type: | String[] |
Alias: | TC |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-TemplateFile
Spécifie un fichier, en tant que tableau, qui contient un modèle pour l’analyse souhaitée de la chaîne. Dans le fichier de modèle, les propriétés et leurs valeurs sont placées entre crochets, comme indiqué ci-dessous. Si une propriété, telle que la propriété Name et ses autres propriétés associées, s’affiche plusieurs fois, vous pouvez ajouter un astérisque (*
) pour indiquer que cela entraîne plusieurs enregistrements. Cela évite d’extraire plusieurs propriétés dans un enregistrement unique.
{Name*:D avid Chew} {City :Redmond}, {State :WA} {Name* :Evan Narvaez} {Name* :Antonio Moreno} {City :Issaquah}, {State :WA}
Type: | String[] |
Alias: | TF |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UpdateTemplate
Indique que cette applet de commande enregistre les résultats d’un algorithme d’apprentissage dans un commentaire dans le fichier de modèle. Cela accélère le processus d’apprentissage de l’algorithme. Pour utiliser ce paramètre, vous devez également spécifier un fichier de modèle avec le paramètre TemplateFile .
Type: | SwitchParameter |
Alias: | UT |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
Sorties
Notes
Windows PowerShell inclut les alias suivants pour ConvertFrom-String
:
CFS