Export-Clixml
개체 또는 개체의 XML 기반 표현을 만들어 파일에 저장합니다.
구문
ByPath (기본값)
Export-Clixml
[-Path] <String>
-InputObject <PSObject>
[-Depth <Int32>]
[-Force]
[-NoClobber]
[-Encoding <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByLiteralPath
Export-Clixml
-LiteralPath <String>
-InputObject <PSObject>
[-Depth <Int32>]
[-Force]
[-NoClobber]
[-Encoding <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Export-Clixml cmdlet은 개체를 CLI(공용 언어 인프라) XML 기반 표현으로 직렬화하여 파일에 저장합니다. 그런 다음 Import-Clixml cmdlet을 사용하여 해당 파일의 내용에 따라 저장된 개체를 다시 만들 수 있습니다. CLI에 대한 자세한 내용은 언어 독립성참조하세요.
이 cmdlet은 ConvertTo-Xml 결과 XML을 파일에 저장한다는 점을 제외하고 Export-Clixml비슷합니다.
ConvertTo-Xml XML을 반환하므로 PowerShell에서 계속 처리할 수 있습니다.
Windows 컴퓨터에서 Export-Clixml 사용하는 중요한 방법은 자격 증명을 내보내고 문자열을 XML로 안전하게 보호하는 것입니다. 예제는 예제 3을 참조하세요.
예제
예제 1: XML 파일로 문자열 내보내기
다음은 현재 디렉터리에 저장되는 XML 파일을 만드는 예제입니다. 이 파일은 테스트
"This is a test" | Export-Clixml -Path .\sample.xml
This is a test 문자열이 파이프라인 아래로 전송됩니다.
Export-Clixml
Path 매개 변수를 사용하여 현재 디렉터리에 sample.xml XML 파일을 만듭니다.
예제 2: XML 파일로 개체 내보내기
이 예제에서는 XML 파일로 개체를 내보낸 다음 파일에서 XML을 가져와 개체를 만드는 방법을 보여줍니다.
Get-Acl C:\test.txt | Export-Clixml -Path .\FileACL.xml
$fileacl = Import-Clixml -Path .\FileACL.xml
Get-Acl cmdlet은 Test.txt 파일의 보안 설명자를 가져옵니다. 파이프라인 아래로 개체를 보내 보안 설명자를 전달하여 Export-Clixml. 개체의 XML 기반 표현은 FileACL.xml파일에 저장됩니다.
Import-Clixml cmdlet은 FileACL.xml 파일의 XML에서 개체를 만듭니다. 그런 다음 개체를 $fileacl 변수에 저장합니다.
예제 3: 내보낸 자격 증명 개체 암호화
이 예제에서는 $Credential cmdlet을 실행하여 Get-Credential 변수에 저장한 자격 증명이 지정된 경우 Export-Clixml cmdlet을 실행하여 자격 증명을 디스크에 저장할 수 있습니다.
중요합니다
Export-Clixml Windows에서 암호화된 자격 증명만 내보냅니다. macOS 및 Linux와 같은 비 Windows 운영 체제에서 자격 증명은 유니코드 문자 배열로 저장된 일반 텍스트로 내보내집니다. 이 경우 일부 난독 처리가 제공되지만 암호화는 제공하지 않습니다.
$Credxmlpath = Join-Path (Split-Path $PROFILE) TestScript.ps1.credential
$Credential | Export-Clixml $Credxmlpath
$Credxmlpath = Join-Path (Split-Path $PROFILE) TestScript.ps1.credential
$Credential = Import-Clixml $Credxmlpath
Export-Clixml cmdlet은 Windows Data Protection API사용하여 자격 증명 개체를 암호화합니다. 암호화를 사용하면 해당 컴퓨터의 사용자 계정만 자격 증명 개체의 내용을 해독할 수 있습니다.
내보낸 CLIXML 파일은 다른 컴퓨터나 다른 사용자가 사용할 수 없습니다.
이 예제에서 자격 증명이 저장되는 파일은 TestScript.ps1.credential표시됩니다.
TestScript 자격 증명을 로드하는 스크립트의 이름으로 바꿉 있습니다.
파이프라인 아래로 자격 증명 개체를 보내 Export-Clixml첫 번째 명령에서 지정한 경로($Credxmlpath)에 저장합니다.
자격 증명을 스크립트로 자동으로 가져오려면 마지막 두 명령을 실행합니다.
Import-Clixml 실행하여 보안 자격 증명 개체를 스크립트로 가져옵니다. 이 가져오기를 사용하면 스크립트에서 일반 텍스트 암호를 노출할 위험이 없습니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Depth
XML 표현에 포함된 개체의 수준을 지정합니다. 기본값은 2입니다.
Types.ps1xml 파일의 개체 형식에 대해 기본값을 재정의할 수 있습니다. 자세한 내용은 about_Types.ps1xml참조하세요.
매개 변수 속성
| 형식: | Int32 |
| Default value: | 2 |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Encoding
대상 파일의 인코딩 형식을 지정합니다. 기본값은 유니코드
이 매개 변수에 허용되는 값은 다음과 같습니다.
-
ASCIIASCII(7비트) 문자 집합을 사용합니다. -
BigEndianUnicode는 빅 엔디안 바이트 순서로 UTF-16을 사용합니다. -
Default시스템의 활성 코드 페이지(일반적으로 ANSI)에 해당하는 인코딩을 사용합니다. -
OEM시스템의 현재 OEM 코드 페이지에 해당하는 인코딩을 사용합니다. -
UnicodeUTF-16을 리틀 엔디안 바이트 순서로 사용합니다. -
UTF7UTF-7을 사용합니다. -
UTF8UTF-8을 사용합니다. -
UTF32UTF-32를 리틀 엔디언 바이트 순서로 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | Unicode |
| 허용되는 값: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.
필요한 경우 cmdlet이 출력 파일의 읽기 전용 특성을 지우도록 합니다. cmdlet은 명령이 완료되면 읽기 전용 특성을 다시 설정하려고 시도합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-InputObject
변환할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다. 개체를 Export-Clixml에 전달할 수도 있습니다.
매개 변수 속성
| 형식: | PSObject |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-LiteralPath
개체의 XML 표현이 저장될 파일의 경로를 지정합니다. Path달리 LiteralPath 매개 변수의 값은 입력된 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | PSPath |
매개 변수 집합
ByLiteralPath
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-NoClobber
cmdlet이 기존 파일의 내용을 덮어쓰지 않음을 나타냅니다. 기본적으로 지정된 경로에 파일이 있는 경우 Export-Clixml 경고 없이 파일을 덮어씁니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | NoOverwrite |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Path
개체의 XML 표현이 저장될 파일의 경로를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByPath
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | 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
이 cmdlet에 개체를 파이프라인할 수 있습니다.
출력
FileInfo
이 cmdlet은 저장된 데이터를 사용하여 만든 파일을 나타내는 FileInfo 개체를 반환합니다.
