다음을 통해 공유


ConvertTo-CliXml

개체를 CliXml 형식 문자열로 변환합니다.

구문

ConvertTo-CliXml
              [-InputObject] <PSObject>
              [-Depth <Int32>]
              [<CommonParameters>]

Description

cmdlet은 ConvertTo-CliXml 개체를 CLI(공용 언어 인프라) XML 형식의 문자열로 변환합니다. 이 명령은 유사 Export-Clixml하지만 파일에 쓰지 않습니다. 대신 문자열을 출력합니다.

이 cmdlet은 PowerShell 7.5-preview.4에서 도입되었습니다.

예제

예제 1 - 프로세스 개체를 CliXml로 변환 및 뒤로 변환

이 예제에서는 프로세스 개체를 CliXml로 변환하고 뒤로 변환한 결과를 보여줍니다. 먼저 현재 프로세스가 변수 $process에 저장됩니다. 프로세스 개체의 PSTypeNames 속성은 개체가 System.Diagnostics.Process 형식임을 보여 줍니다. 다음 명령은 프로세스 개체의 각 멤버 유형에 대한 개수를 표시합니다.

$process = Get-Process -Id $PID
$process.PSTypeNames

System.Diagnostics.Process
System.ComponentModel.Component
System.MarshalByRefObject
System.Object

$process | Get-Member | Group-Object MemberType | Select-Object Name, Count

Name           Count
----           -----
AliasProperty      7
CodeProperty       1
Property          52
NoteProperty       1
ScriptProperty     8
PropertySet        2
Method            19
Event              4

$xml = $process | ConvertTo-CliXml
$fromXML = ConvertFrom-CliXml $xml
$fromXML.PSTypeNames

Deserialized.System.Diagnostics.Process
Deserialized.System.ComponentModel.Component
Deserialized.System.MarshalByRefObject
Deserialized.System.Object

$fromXML | Get-Member | Group-Object MemberType | Select-Object Name, Count

Name         Count
----         -----
Property        46
NoteProperty    17
PropertySet      2
Method           2

다음으로 프로세스 개체가 CliXml로 변환되고 뒤로 변환됩니다. 새 개체의 형식은 접두사로 Deserialized입니다. 새 개체의 멤버 수는 원래 개체와 다릅니다.

매개 변수

-Depth

XML 표현에 포함된 개체의 수준을 지정합니다. 기본값은 2입니다.

형식:Int32
Position:Named
Default value:2
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

CliXml 형식 문자열로 변환할 개체입니다.

형식:PSObject
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

PSObject

출력

String