개체의 XML 기반 표시를 만들고 이 표시를 파일에 저장합니다.

구문

Export-Clixml [-Path] <string> -InputObject <psobject> [-Depth <int>] [-Encoding <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Export-Clixml cmdlet은 개체의 XML 기반 표시를 만들어서 파일에 저장합니다. 그러면 Import-CLIXML cmdlet를 사용하여 해당 파일의 내용을 기반으로 저장된 개체를 다시 만들 수 있습니다.

이 cmdlet은 ConvertTo-XML이 결과 XML을 파일에 저장한다는 점을 제외하면 Export-Clixml과 유사합니다. ConvertTo-XML은 XML을 반환하므로 Windows PowerShell에서 계속하여 처리할 수 있습니다.

매개 변수

-Depth <int>

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

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

필수 여부

false

위치

named

기본값

2

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Encoding <string>

대상 파일의 인코딩 유형을 지정합니다. 유효한 값은 ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default 및 OEM입니다. 기본값은 UTF8입니다.

필수 여부

false

위치

named

기본값

UTF8

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Force

필요한 경우 Cmdlet을 사용하여 출력 파일의 읽기 전용 특성을 제거합니다. 명령이 완료되면 cmdlet이 읽기 전용 특성을 다시 설정하려 합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-InputObject <psobject>

변환할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오. 개체를 Export-Clixml로 파이프할 수도 있습니다.

필수 여부

true

위치

named

기본값

파이프라인 입력 적용 여부

true (ByValue)

와일드카드 문자 적용 여부

false

-NoClobber

cmdlet이 기존 파일의 내용을 덮어쓰지 않도록 합니다. 파일이 지정된 경로에 있는 경우 Export-Clixml은 기본적으로 경고 없이 파일을 덮어씁니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Path <string>

개체의 XML 표시를 저장할 파일 경로를 지정합니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSObject

임의의 개체를 Export-Clixml로 파이프할 수 있습니다.

출력

System.IO.FileInfo

Export-Clixml은 XML이 포함된 파일을 만듭니다.

예 1

C:\PS>"This is a test" | export-clixml sample.xml

설명
-----------
이 명령은 "This is a test"라는 문자열의 표시를 저장하는 XML 파일을 만듭니다.

예 2

C:\PS>get-acl C:\test.txt | export-clixml -Path fileacl.xml

C:\PS> $fileacl = import-clixml fileacl.xml

설명
-----------
이 예에서는 개체를 XML 파일로 내보낸 다음 파일에서 XML을 가져와 개체를 만드는 방법을 보여 줍니다. 

첫 번째 명령은 Get-ACL cmdlet을 사용하여 Test.txt 파일의 보안 설명자를 가져옵니다. 파이프라인 연산자를 사용하여 보안 설명자를 Export-Clixml로 전달하면 이 cmdlet은 개체의 XML 기반 표시를 FileACL.xml이라는 파일에 저장합니다. 

두 번째 명령은 Import-Clixml cmdlet을 사용하여 FileACL.xml 파일에 있는 XML에서 개체를 만듭니다. 그런 다음 이 명령은 개체를 $FileAcl 변수에 저장합니다.

참고 항목



목차