Out-String

Out-String
    [-Stream]
    [-Width <Int32>]
    [-InputObject <PSObject>]
    [<CommonParameters>]

L’applet de commande Out-String convertit les objets que Windows PowerShell gère en tableau de chaînes. Par défaut, Out-String accumule les chaînes et les retourne sous forme de chaîne unique, mais vous pouvez utiliser le paramètre Stream pour diriger Out-String pour retourner une chaîne à la fois. Cette applet de commande vous permet de rechercher et de manipuler la sortie de chaîne comme vous le feriez dans les interpréteurs de commandes traditionnels lorsque la manipulation d’objets est moins pratique.

PS C:\> Get-Content C:\test1\testfile2.txt | Out-String

Cette commande envoie le contenu du fichier Testfile2.txt à la console sous forme de chaîne unique. Il utilise l’applet de commande Get-Content pour obtenir le contenu du fichier. L’opérateur de pipeline (|) envoie le contenu à Out-String, qui envoie le contenu à la console sous forme de chaîne.

La première commande utilise l’applet de commande Get-Culture pour obtenir les paramètres régionaux. L’opérateur de pipeline (|) envoie le résultat à l’applet de commande Select-Object, qui sélectionne toutes les propriétés (*) de l’objet de culture qui Get-Culture retourné. La commande stocke ensuite les résultats dans la variable $C.

La deuxième commande utilise l’applet de commande Out-String pour convertir l’objet CultureInfo en une série de chaînes (une chaîne pour chaque propriété). Il utilise le paramètre InputObject pour passer la variable à . Le paramètre Width est défini sur 100 caractères par ligne pour empêcher la troncation.

PS C:\> $C = Get-Culture | Select-Object *
PS C:\> Out-String -InputObject $C -Width 100

Ces commandes obtiennent les paramètres régionaux de l’utilisateur actuel et convertissent les données en chaînes.

PS C:\> Get-Alias | Out-String -Stream | Select-String "Get-Command"

Cet exemple illustre la différence entre l’utilisation d’objets et l’utilisation de chaînes. La commande affiche des alias qui incluent l’expression « Get-Command ». Il utilise l’applet de commande pour obtenir un ensemble d’objets aliasInfo (un pour chaque alias de la session active).

L’opérateur de pipeline (|) envoie la sortie de l’applet de commande Get-Alias à l’applet de commande Out-String, qui convertit les objets en une série de chaînes. Il utilise le paramètre Stream de Out-String pour envoyer chaque chaîne individuellement, au lieu de les concaténer en une seule chaîne. Un autre opérateur de pipeline envoie les chaînes à l’applet de commande Select-String, qui sélectionne les chaînes qui incluent « Get-Command » n’importe où dans la chaîne.

Si vous omettez le paramètre Stream, la commande affiche tous les alias, car Select-String trouve « Get-Command » dans la chaîne unique retournée par Out-String, et le formateur affiche la chaîne sous forme de tableau.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger des objets vers Out-String.

Out-String retourne la chaîne qu’elle crée à partir de l’objet d’entrée.

• Applets de commande qui contiennent le verbe Out qui ne mettez pas en forme les objets ; ils les affichent et les envoient à la destination d’affichage spécifiée. Si vous envoyez un objet non mis en forme à une applet de commande Out, l’applet de commande l’envoie à une applet de commande de mise en forme avant de la rendre.
• Les applets de commande Out n’ont pas de paramètres qui prennent des noms ou des chemins d’accès aux fichiers. Pour envoyer des données à une applet de commande Out, utilisez un opérateur de pipeline (|) pour envoyer la sortie d’une commande Windows PowerShell à l’applet de commande. Vous pouvez également stocker des données dans une variable et utiliser le paramètre InputObject pour transmettre les données à l’applet de commande.