Export-Alias
현재 정의된 별칭에 대한 정보를 파일로 내보냅니다.
구문
Export-Alias [-Path] <string> [[-Name] <string[]>] [-Append] [-As {<Csv> | <Script>}] [-Description <string>] [-Force] [-NoClobber] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Export-Alias cmdlet은 현재 세션의 별칭을 파일로 내보냅니다. 출력 파일이 없으면 cmdlet에서 출력 파일을 만듭니다.
Export-Alias는 특정 범위 또는 모든 범위의 별칭을 내보낼 수 있으며 데이터를 CSV 형식으로 생성하거나 세션 또는 Windows PowerShell 프로필에 추가할 수 있는 일련의 Set-Alias 명령으로 생성할 수 있습니다.
매개 변수
-Append
출력을 지정된 파일의 기존 내용에 덮어쓰지 않고 이 파일에 추가합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-As <ExportAliasFormat>
출력 형식을 결정합니다. 기본값은 CSV입니다.
유효한 값은 다음과 같습니다.
-- CSV: CSV(쉼표로 구분된 값) 형식입니다.
-- Script: 내보낸 각 별칭에 대해 Set-Alias 명령을 만듭니다. 출력 파일 이름 확장명을 .ps1으로 지정하면 별칭을 세션에 추가하는 스크립트로 실행할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Description <string>
내보낸 파일에 설명을 추가합니다. 설명은 파일의 위쪽 머리글 정보 다음에 주석으로 나타납니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Force
파일에 읽기 전용 특성이 설정되어 있는 경우에도 출력 파일을 덮어씁니다.
Export-Alias는 기본적으로 읽기 전용 또는 숨김 특성이 설정되어 있지 않고 명령에 NoClobber 매개 변수가 사용되지 않은 경우 경고 없이 파일을 덮어씁니다. 명령에 함께 사용하는 경우 NoClobber 매개 변수가 Force 매개 변수보다 우선적으로 적용됩니다.
Force 매개 변수를 사용해도 Export-Alias는 숨김 특성을 가진 파일을 덮어쓸 수 없습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
읽기 전용 파일을 덮어쓰지 않습니다. |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Name <string[]>
내보낼 별칭의 이름을 지정합니다. 와일드카드를 사용할 수 있습니다.
기본적으로 Export-Alias는 세션 또는 범위의 모든 별칭을 내보냅니다.
필수 여부 |
false |
위치 |
2 |
기본값 |
모든 별칭을 내보냅니다. |
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
false |
-NoClobber
명령에 Force 매개 변수가 사용된 경우에도 Export-Alias가 파일을 덮어쓰지 못하도록 지정합니다.
NoClobber 매개 변수가 생략된 경우 Export-Alias는 파일에 읽기 전용 특성이 설정되어 있지 않으면 경고 없이 기존 파일을 덮어씁니다. NoClobber는 Export-Alias가 읽기 전용 특성이 있는 파일을 덮어쓸 수 있도록 허용하는 Force 매개 변수보다 우선적으로 적용됩니다.
NoClobber를 사용해도 Append 매개 변수는 기존 파일에 내용을 추가할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
읽기-쓰기 파일을 덮어씁니다. |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-PassThru
내보낸 별칭을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
출력 없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Path <string>
출력 파일의 경로를 지정합니다. 와일드카드를 사용할 수는 있지만 결과 경로 값은 하나의 파일 이름을 도출해야 합니다. 이 매개 변수는 필수 사항입니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Scope <string>
별칭을 내보낼 범위를 지정합니다.
유효한 값은 "Global", "Local", "Script" 또는 현재 범위와 관련된 수(0부터 범위의 수까지, 여기서 0은 현재 범위이고 1은 그 상위 범위)입니다. "Local"이 기본값입니다. 자세한 내용은 about_Scopes를 참조하십시오.
필수 여부 |
false |
위치 |
named |
기본값 |
Local |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
없음 개체를 이 cmdlet으로 파이프할 수 없습니다. |
출력 |
없음 또는 System.Management.Automation.AliasInfo Passthru 매개 변수를 사용하는 경우 Export-Alias는 별칭을 나타내는 System.Management.Automation.AliasInfo 개체를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다. |
참고
파일로만 Export-Alias를 수행할 수 있습니다.
예 1
C:\PS>export-alias -path alias.csv
설명
-----------
이 명령은 현재 별칭 정보를 현재 디렉터리의 Alias.csv 파일로 내보냅니다.
예 2
C:\PS>export-alias -path alias.csv -noclobber
설명
-----------
이 명령은 현재 세션의 별칭을 Alias.csv 파일로 내보냅니다.
NoClobber 매개 변수가 지정되었으므로 Alias.csv 파일이 현재 디렉터리에 이미 있는 경우 이 명령은 실패합니다.
예 3
C:\PS>export-alias -path alias.csv -append -description "Appended Aliases" -force
설명
-----------
이 명령은 현재 세션의 별칭을 Alias.csv 파일에 추가합니다.
이 명령은 Description 매개 변수를 사용하여 파일의 맨 위에 있는 주석에 설명을 추가합니다.
이 명령은 또한 Force 매개 변수를 사용하여 파일에 읽기 전용 특성이 있는 경우에도 기존 Alias.csv 파일을 덮어씁니다.
예 4
C:\PS>export-alias -path alias.ps1 -as script
C:\PS> add-content -path $profile -value (get-content alias.ps1)
C:\PS> $s = new-pssession -computername Server01
C:\PS> invoke-command -session $s -filepath .\alias.ps1
설명
-----------
이 예에서는 Export-Alias가 생성하는 스크립트 파일 형식을 사용하는 방법을 보여 줍니다.
첫 번째 명령은 세션의 별칭을 Alias.ps1 파일로 내보냅니다. 이 명령은 Script 값과 함께 As 매개 변수를 사용하여 각 별칭에 대한 Set-Alias 명령이 포함된 파일을 생성합니다.
두 번째 명령은 Alias.ps1 파일의 별칭을 CurrentUser-CurrentHost 프로필에 추가합니다. (프로필의 경로는 $profile 변수에 저장됩니다.) 이 명령은 Get-Content cmdlet을 사용하여 Alias.ps1 파일에서 별칭을 가져온 다음 Add-Content cmdlet을 사용하여 프로필에 추가합니다. 자세한 내용은 about_Profiles를 참조하십시오.
세 번째 및 네 번째 명령은 Alias.ps1 파일의 별칭을 Server01 컴퓨터의 원격 세션에 추가합니다. 세 번째 명령은 New-PSSession cmdlet을 사용하여 세션을 만듭니다. 네 번째 명령은 Invoke-Command cmdlet의 FilePath 매개 변수를 사용하여 새 세션에서 Alias.ps1 파일을 실행합니다.