Convert-String

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

例に一致するように文字列を書式設定します。

構文

Convert-String
       [-Example <System.Collections.Generic.List`1[System.Management.Automation.PSObject]>]
       -InputObject <String>
       [<CommonParameters>]

説明

コマンドレットは、例の形式に合わせて文字列を書式設定します。

例

例 1: 文字列の形式を変換する

"Mu Han", "Jim Hance", "David Ahs", "Kim Akers" | Convert-String -Example "Ed Wilson=Wilson, E."

Han, M.
Hance, J.
Ahs, D.
Akers, K.

最初のコマンドは、姓と名を含む配列を作成します。

2 番目のコマンドは、例に従って名前の書式を設定します。 出力の先頭に姓を置き、その後にイニシャルを入力します。

例 2: 文字列の書式を簡略化する

$composers = @("Johann Sebastian Bach", "Wolfgang Amadeus Mozart", "Frederic Francois Chopin", "Johannes Brahms")
$composers | Convert-String -Example "first middle last=last, first"

Bach, Johann
Mozart, Wolfgang
Chopin, Frederic
Brahms, Johannes

最初のコマンドは、名、中、姓を含む配列を作成します。 最後のエントリにはミドル ネームがないことに注意してください。

2 番目のコマンドは、例に従って名前の書式を設定します。 出力の先頭に姓を付け、その後に名を付けます。 すべてのミドル ネームが削除されました。ミドル ネームのないエントリが正しく処理されます。

例 3: 文字列が一致しない場合の出力管理の例

$composers = @("Johann Sebastian Bach", "Wolfgang Amadeus Mozart", "Frederic Francois Chopin", "Johannes Brahms")
$composers | Convert-String -Example "first middle last=middle, first"

Sebastian, Johann
Amadeus, Wolfgang
Francois, Frederic

最初のコマンドは、名、中、姓を含む配列を作成します。 最後のエントリにはミドル ネームがないことに注意してください。

2 番目のコマンドは、例に従って名前の書式を設定します。 出力の先頭に ミドル ネーム を付け、その後に名を付けます。 サンプル パターンと $Composers 一致しないため、最後のエントリはスキップされます。ミドル ネームはありません。

例 4: 美容空間に注意する

$composers = @("Antonio Vivaldi", "Richard Wagner ", "Franz Schubert", "Johannes Brahms ")
$composers | Convert-String -Example "Patti Fuller = Fuller, P."

Wagner, R.
 Brahms, J.

最初のコマンドは、姓と名の配列を作成します。 2 番目と 4 番目の項目には、姓の後に余分な末尾のスペースがあることに注意してください。

2 番目のコマンドは、サンプル パターン に一致するすべての文字列 (単語、スペース、単語、最後の末尾のスペース) を等号 (=) の前に変換します。 また、出力の先頭のスペースにも注意してください。

例 5: 複数のパターンでプロセス情報を書式設定する

$ExamplePatterns = @(
    @{before='"Hello","World"'; after='World: Hello'},
    @{before='"Hello","1"'; after='1: Hello'},
    @{before='"Hello-World","22"'; after='22: Hello-World'},
    @{before='"hello world","333"'; after='333: hello world'}
)
$Processes = Get-Process   | Select-Object -Property ProcessName, Id | ConvertTo-Csv -NoTypeInformation
$Processes | Convert-String -Example $ExamplePatterns

Id: ProcessName
4368: AGSService
8896: Amazon Music Helper
4420: AppleMobileDeviceService
...
11140: git-bash
0: Idle
...
56: Secure System
...
13028: WmiPrvSE
2724: WUDFHost
2980: WUDFHost
3348: WUDFHost

$ExamplePatternsでは、例を使用して、データ内のさまざまな予期されるパターンを定義します。

最初のパターンは、 @{before='"Hello","World"'; after='World: Hello'}次のように読み取られます。

  • は、単語が二重引用符で囲まれた後、コンマで囲まれた文字列を受け取ります。
  • 次に、2番目の単語と最後の単語を引用符で囲みます。
  • 文字列内にスペースがありません。 出力: 2 番目の単語を最初に配置します。
  • 引用符なし、1 つのスペース、次に最初の単語 (引用符なし)。

2 番目のパターンは、 @{before='"Hello","1"'; after='1: Hello'}次のように読み取ります。

  • は、単語が二重引用符で囲まれた後、コンマで囲まれた文字列を受け取ります。
  • その後、引用符で囲まれた数値。
  • 文字列内にスペースがありません。 出力: 数値を最初に配置します。
  • 引用符なし、1 つのスペース、次に引用符なしの単語。

3 番目のパターンは、 @{before='"Hello-World","22"'; after='22: Hello-World'}次のように読み取ります。

  • の間にハイフンが入った 2 つの単語が
  • 二重引用符、コンマ、および引用符で囲まれた数値。
  • コンマと 3 番目の二重引用符の間にスペースがありません。
  • 出力: 数値を最初に配置し、引用符を付けずに、次に 1 つのスペースを配置します。
  • 次に、ハイフンで囲まれた単語を引用符で囲まずに指定します。

4 番目と最後のパターンは、 @{before='"hello world","333"'; after='333: hello world'}次のように読み取ります。

  • は、間にスペースがある 2 つの単語が囲まれている文字列を予期します。
  • 二重引用符、コンマ、および引用符で囲まれた数値。
  • コンマと 3 番目の二重引用符の間にスペースがありません。
  • 出力: 数値を最初に配置し、引用符を付けずに、次に 1 つのスペースを配置します。
  • 次に、スペースを含む単語を引用符なしで指定します。

最初のコマンドは、Get-Process コマンドレットを使用してすべてのプロセスを取得します。 このコマンドは、プロセス名とプロセス ID を選択する Select-Object コマンドレットに渡します。 パイプラインの最後で、コマンドは ConvertTo-Csv コマンドレットを使用して、型情報なしで出力をコンマ区切りの値に変換します。 このコマンドは、結果を $Processes 変数に格納します。 $Processesプロセス名と PID が含まれるようになりました。

2 番目のコマンドは、入力項目の順序を変更する変数の例を指定します。 このコマンドは、各文字列 $Processesを .

Note

4 番目のパターンは、スペースで区切られた 2 つ以上の単語が一致することを暗黙的に示しています。 4 番目のパターンがないと、二重引用符で囲まれた文字列の最初の単語のみが照合されます。

パラメーター

-Example

ターゲット形式の例の一覧を指定します。 次の例のように、左にソース パターン、右側にターゲット パターンを使用して、等号 (=) で区切られたペアを指定します。

  • -Example "Hello World=World, Hello"
  • -Example "Hello World=World: Hello",'"Hello","1"=1: Hello'

Note

2 番目の例では、パターンの一覧を使用します

または、Before プロパティと After プロパティを含むハッシュ テーブルの一覧を指定します。

  • -Example @{before='"Hello","World"'; after='World: Hello'}, @{before='"Hello","1"'; after='1: Hello'}

注意

等号 (=) の周りにスペースを使用しないでください。これは、パターンの一部として扱われます。

Type:List<T>[PSObject]
Aliases:E
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

書式設定する文字列を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

String

このコマンドレットに文字列をパイプできます。

出力

String

このコマンドレットは文字列を返します。