다음을 통해 공유

ConvertTo-Xml

  • 참조
모듈:
Microsoft.PowerShell.Utility

개체의 XML 기반 표현을 만듭니다.

구문

ConvertTo-Xml
              [-Depth <Int32>]
              [-InputObject] <PSObject>
              [-NoTypeInformation]
              [-As <String>]
              [<CommonParameters>]

Description

cmdlet은 ConvertTo-Xml 하나 이상의 .NET 개체에 대한 XML 기반 표현을 만듭니다. 이 cmdlet을 사용하려면 하나 이상의 개체를 cmdlet에 파이프하거나 InputObject 매개 변수를 사용하여 개체를 지정합니다.

여러 개체를 InputObject 매개 변수로 ConvertTo-Xml 파이프하거나 여러 개체를 제출하는 경우 모든 개체 ConvertTo-Xml 의 표현을 포함하는 단일 메모리 내 XML 문서를 반환합니다.

이 cmdlet은 Import-Clixml을 사용하여 개체로 다시 가져올 수 있는 결과 XML을 CLI(공용 언어 인프라) 파일에 저장한다는 점을 제외하고 Export-Clixml Export-Clixml과 유사합니다. ConvertTo-Xml 는 XML 문서의 메모리 내 표현을 반환하므로 PowerShell에서 계속 처리할 수 있습니다. ConvertTo-Xml 에는 개체를 CLI XML로 변환하는 옵션이 없습니다.

예제

예제 1: 날짜를 XML로 변환

Get-Date | ConvertTo-Xml

이 명령은 현재 날짜( DateTime 개체)를 XML로 변환합니다.

예제 2: 프로세스를 XML로 변환

ConvertTo-Xml -As "Document" -InputObject (Get-Process) -Depth 3

이 명령은 컴퓨터의 모든 프로세스를 나타내는 프로세스 개체를 XML 문서로 변환합니다. 개체는 수준 3까지 확장됩니다.

매개 변수

-As

출력 형식을 결정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • String - 단일 문자열을 반환합니다.
  • Stream - 문자열 배열을 반환합니다.
  • Document- XmlDocument 개체를 반환합니다.

기본값은 Document입니다.

형식:String
허용되는 값:Stream, String, Document
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Depth

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

예를 들어 개체의 속성에도 개체가 포함된 경우 포함된 개체의 속성에 대한 XML 표현을 저장하려면 깊이를 2로 지정해야 합니다.

Types.ps1xml 파일의 개체 형식에 대해 기본값을 재정의할 수 있습니다. 자세한 내용은 about_Types.ps1xml을 참조하세요.

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

-InputObject

변환할 개체를 지정합니다. 개체를 포함하는 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하세요. 개체를 으로 파이프할 ConvertTo-XML수도 있습니다.

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

-NoTypeInformation

개체 노드에서 Type 특성을 생략합니다.

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

String

As 매개 변수를 사용하고 값을 string설정하면 이 cmdlet은 XML을 문자열로 반환합니다. 값이면 이 cmdlet은 stream문자열 배열을 반환합니다.

XmlDocument

기본적으로 이 cmdlet은 XML 문서를 반환합니다.