다음을 통해 공유

ConvertTo-Xml

모듈:
Microsoft.PowerShell.Utility Module

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

구문

Default (기본값) 

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

Description

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

여러 개체를 ConvertTo-Xml 파이프하거나 InputObject 매개 변수를 사용하여 여러 개체를 제출하면 모든 ConvertTo-Xml 개체의 표현이 포함된 단일 메모리 내 XML 문서가 반환됩니다.

이 cmdlet은 Import-Clixml을 사용하여 개체로 다시 가져올 수 있는 CLI(공용 언어 인프라) XML 파일에 결과 XML을 저장한다는 점을 제외하면 Export-ClixmlExport-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 문서로 변환합니다. 개체는 세 가지 수준의 깊이로 확장됩니다.

매개 변수

-As

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

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

기본값은 Document입니다.

매개 변수 속성

형식:String
Default value:None
허용되는 값:Stream, String, Document
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Depth

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

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

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

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputObject

변환할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다. 개체를 ConvertTo-XML에 전달할 수도 있습니다.

매개 변수 속성

형식:PSObject
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NoTypeInformation

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSObject

모든 개체를 ConvertTo-XML파이프할 수 있습니다.

출력

System.String or System.Xml.XmlDocument

As 매개 변수의 값은 반환되는 ConvertTo-XML 개체의 형식을 결정합니다.