개체의 XML 기반 표시를 만듭니다.
구문
ConvertTo-XML [-InputObject] <psobject> [-As <string>] [-Depth <int>] [-NoTypeInformation] [<CommonParameters>]
설명
ConvertTo-Xml cmdlet은 하나 이상의 Microsoft .NET Framework 개체의 XML 기반 표시를 만듭니다. 이 cmdlet을 사용하려면 하나 이상의 개체를 cmdlet으로 파이프하거나 InputObject 매개 변수를 사용하여 개체를 지정합니다.
여러 개체를 ConvertTo-XML로 파이프하거나 InputObject 매개 변수를 사용하여 여러 개체를 전송하면 ConvertTo-XML은 모든 개체의 표시를 포함하는 단일 XML 문서를 반환합니다.
이 cmdlet은 Export-Clixml이 결과 XML을 파일에 저장한다는 점을 제외하면 Export-Clixml과 유사합니다. ConvertTo-XML은 XML을 반환하므로 Windows PowerShell에서 계속하여 처리할 수 있습니다.
매개 변수
-As <string>
출력 형식을 결정합니다. 유효한 값은 다음과 같습니다.
-- String: 단일 문자열을 반환합니다.
-- Stream: 문자열 배열을 반환합니다.
-- Document: XmlDocument 개체를 반환합니다.
기본값은 Stream입니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
Stream |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-Depth <int>
XML 표시에 포함할 포함 개체 수준을 지정합니다. 기본값은 1입니다.
예를 들어 개체의 속성에 또 개체가 포함된 경우 포함 개체 속성의 XML 표시를 저장하려면 수준을 2로 지정해야 합니다.
Types.ps1xml 파일에서 개체 유형에 대해 기본값을 재정의할 수 있습니다. 자세한 내용은 about_Types.ps1xml을 참조하십시오.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
1 |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
-InputObject <psobject>
변환할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오. 개체를 ConvertTo-XML로 파이프할 수도 있습니다.
|
필수 여부 |
true |
|
위치 |
1 |
|
기본값 |
없음 |
|
파이프라인 입력 적용 여부 |
true (ByValue) |
|
와일드카드 문자 적용 여부 |
true |
-NoTypeInformation
개체 노드에서 Type 특성을 생략합니다.
|
필수 여부 |
false |
|
위치 |
named |
|
기본값 |
False |
|
파이프라인 입력 적용 여부 |
false |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
System.Management.Automation.PSObject 임의의 개체를 ConvertTo-XML로 파이프할 수 있습니다. |
|
출력 |
System.String 또는 System.Xml.XmlDocument As 매개 변수의 값에 따라 ConvertTo-XML이 반환하는 개체의 유형이 달라집니다. |
예 1
C:\PS>get-date | convertto-xml 설명 ----------- 이 명령은 현재 날짜(DateTime 개체)를 XML로 변환합니다.
예 2
C:\PS>convertto-xml -as Document -inputObject (get-process) -depth 3 설명 ----------- 이 명령은 컴퓨터의 모든 프로세스를 나타내는 프로세스 개체를 XML 문서로 변환합니다. 개체는 수준 3까지 확장됩니다.
참고 항목