Join-String

구문

Join-String
    [[-Property] <PSPropertyExpression>]
    [[-Separator] <String>]
    [-OutputPrefix <String>]
    [-OutputSuffix <String>]
    [-UseCulture]
    [-InputObject <PSObject[]>]
    [<CommonParameters>]

Join-String
    [[-Property] <PSPropertyExpression>]
    [[-Separator] <String>]
    [-OutputPrefix <String>]
    [-OutputSuffix <String>]
    [-SingleQuote]
    [-UseCulture]
    [-InputObject <PSObject[]>]
    [<CommonParameters>]

Join-String
    [[-Property] <PSPropertyExpression>]
    [[-Separator] <String>]
    [-OutputPrefix <String>]
    [-OutputSuffix <String>]
    [-DoubleQuote]
    [-UseCulture]
    [-InputObject <PSObject[]>]
    [<CommonParameters>]

Join-String
    [[-Property] <PSPropertyExpression>]
    [[-Separator] <String>]
    [-OutputPrefix <String>]
    [-OutputSuffix <String>]
    [-FormatString <String>]
    [-UseCulture]
    [-InputObject <PSObject[]>]
    [<CommonParameters>]

Description

cmdlet은 Join-String 파이프라인 개체의 텍스트를 단일 문자열로 조인하거나 결합합니다.

매개 변수를 지정하지 않으면 파이프라인 개체가 문자열로 변환되고 기본 구분 기호 $OFS와 조인됩니다.

속성 이름을 지정하면 속성 값이 문자열로 변환되고 문자열로 조인됩니다.

속성 이름 대신 스크립트 블록을 사용할 수 있습니다. 스크립트 블록의 결과는 결과를 형성하기 위해 조인되기 전에 문자열로 변환됩니다. 개체 속성의 텍스트 또는 문자열로 변환된 개체의 결과를 결합할 수 있습니다.

이 cmdlet은 PowerShell 6.2에서 도입되었습니다.

예제

예제 1: 디렉터리 이름 조인

다음은 디렉터리 이름을 조인하고, 출력을 큰따옴표로 래핑하고, 디렉터리 이름을 쉼표와 공백(, )으로 구분하는 예제입니다. 출력은 문자열 개체입니다.

Get-ChildItem -Directory C:\ | Join-String -Property Name -DoubleQuote -Separator ', '

"PerfLogs", "Program Files", "Program Files (x86)", "Users", "Windows"

Get-ChildItem 는 디렉터리 매개 변수를 사용하여 드라이브의 모든 디렉터리 이름을 C:\ 가져옵니다. 개체는 파이프라인 Join-String아래로 전송됩니다. Property 매개 변수는 디렉터리 이름을 지정합니다. DoubleQuote 매개 변수는 디렉터리 이름을 큰따옴표로 래핑합니다. Separator 매개 변수는 쉼표와 공백(, )을 사용하여 디렉터리 이름을 구분하도록 지정합니다.

개체는 Get-ChildItem System.IO.DirectoryInfo이며 Join-String 개체를 System.String으로 변환합니다.

예제 2: 속성 하위 문자열을 사용하여 디렉터리 이름 조인

다음은 하위 문자열 메서드를 사용하여 디렉터리 이름의 처음 네 글자를 가져와 출력을 작은따옴표로 래핑하고 디렉터리 이름을 세미콜론(;)으로 구분하는 예제입니다.

Get-ChildItem -Directory C:\ | Join-String -Property {$_.Name.SubString(0,4)} -SingleQuote -Separator ';'

'Perf';'Prog';'Prog';'User';'Wind'

Get-ChildItem 는 디렉터리 매개 변수를 사용하여 드라이브의 모든 디렉터리 이름을 C:\ 가져옵니다. 개체는 파이프라인 Join-String아래로 전송됩니다.

속성 매개 변수 스크립트 블록은 자동 변수($_)를 사용하여 각 개체의 Name 속성 부분 문자열을 지정합니다. 부분 문자열은 각 디렉터리 이름의 처음 네 글자를 가져옵니다. 부분 문자열은 문자 시작 및 끝 위치를 지정합니다. SingleQuote 매개 변수는 디렉터리 이름을 작은따옴표로 래핑합니다. Separator 매개 변수는 세미콜론(;)을 사용하여 디렉터리 이름을 구분하도록 지정합니다.

자동 변수 및 부분 문자열에 대한 자세한 내용은 about_Automatic_Variables 및 부분 문자열을 참조하세요.

예제 3: 별도의 줄에 조인 출력 표시

다음은 서비스 이름을 각 서비스에 별도의 줄에 조인하고 탭으로 들여쓰는 예제입니다.

Get-Service -Name se* | Join-String -Property Name -Separator "`r`n`t" -OutputPrefix "Services:`n`t"

Services:
    seclogon
    SecurityHealthService
    SEMgrSvc
    SENS
    Sense
    SensorDataService
    SensorService
    SensrSvc
    SessionEnv

Get-Service 에서는 Name 매개 변수를 사용하여 .로 se*시작하는 서비스를 지정합니다. 별표(*)는 모든 문자에 대한 와일드카드입니다.

개체는 속성 매개 변수를 Join-String 사용하여 서비스 이름을 지정하는 파이프라인 아래로 전송됩니다. Separator 매개 변수는 캐리지 리턴(), 줄 바꿈() 및 탭(`r`n`t)을 나타내는 세 개의 특수 문자를 지정합니다. OutputPrefix는 첫 번째 출력 줄 앞에 새 줄과 탭이 있는 레이블 Services: 을 삽입합니다.

특수 문자에 대한 자세한 내용은 about_Special_Characters 참조하세요.

예제 4: 개체에서 클래스 정의 만들기

이 예제에서는 기존 개체를 템플릿으로 사용하여 PowerShell 클래스 정의를 생성합니다.

이 코드 샘플에서는 스플래팅을 사용하여 줄 길이를 줄이고 가독성을 향상시킵니다. 자세한 내용은 about_Splatting 참조하세요.

$obj = [pscustomobject] @{Name = "Joe"; Age = 42}
$parms = @{
  Property = "Name"
  FormatString = '  ${0}'
  OutputPrefix = "class {`n"
  OutputSuffix = "`n}`n"
  Separator = "`n"
}
$obj.PSObject.Properties | Join-String @parms

class {
  $Name
  $Age
}

매개 변수

-DoubleQuote

-FormatString

-InputObject

-OutputPrefix

-OutputSuffix

-Property

-Separator

-SingleQuote

-UseCulture

입력

PSObject

출력

String

관련 링크

• about_Automatic_Variables
• about_Special_Characters
• Substring