다음을 통해 공유


Export-Alias

현재 정의된 별칭에 대한 정보를 파일로 내보냅니다.

구문

Export-Alias
      [-Path] <String>
      [[-Name] <String[]>]
      [-PassThru]
      [-As <ExportAliasFormat>]
      [-Append]
      [-Force]
      [-NoClobber]
      [-Description <String>]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-Alias
      -LiteralPath <String>
      [[-Name] <String[]>]
      [-PassThru]
      [-As <ExportAliasFormat>]
      [-Append]
      [-Force]
      [-NoClobber]
      [-Description <String>]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Export-Alias 현재 세션의 별칭을 파일로 내보냅니다. 출력 파일이 없으면 cmdlet에서 출력 파일을 만듭니다.

Export-Alias 는 특정 범위 또는 모든 범위에서 별칭을 내보낼 수 있으며, CSV 형식으로 또는 세션 또는 PowerShell 프로필에 추가할 수 있는 일련의 Set-Alias 명령으로 데이터를 생성할 수 있습니다.

예제

예제 1: 별칭 내보내기

Export-Alias -Path "alias.csv"

이 명령은 현재 별칭 정보를 현재 디렉터리의 Alias.csv 파일로 내보냅니다.

예제 2: 내보내기 파일이 아직 없는 경우 별칭 내보내기

Export-Alias -Path "alias.csv" -NoClobber

이 명령은 현재 세션의 별칭을 Alias.csv 파일로 내보냅니다.

NoClobber 매개 변수가 지정되었으므로 Alias.csv 파일이 현재 디렉터리에 이미 있는 경우 명령이 실패합니다.

예제 3: 파일에 별칭 추가

Export-Alias -Path "alias.csv" -Append -Description "Appended Aliases" -Force

이 명령은 현재 세션의 별칭을 Alias.csv 파일에 추가합니다.

이 명령은 Description 매개 변수를 사용하여 파일 맨 위에 있는 주석에 설명을 추가합니다.

또한 이 명령은 Force 매개 변수를 사용하여 읽기 전용 특성이 있더라도 기존 Alias.csv 파일을 덮어씁 수 있습니다.

예제 4: 별칭을 스크립트로 내보내기

Export-Alias -Path "alias.ps1" -As Script
Add-Content -Path $Profile -Value (Get-Content alias.ps1)
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S -FilePath .\alias.ps1

이 예제에서는 생성하는 스크립트 파일 형식 Export-Alias 을 사용하는 방법을 보여 줍니다.

첫 번째 명령은 세션의 별칭을 Alias.ps1 파일로 내보냅니다. 스크립트 값과 As 매개 변수를 사용하여 각 별칭에 대한 Set-Alias 명령을 포함하는 파일을 생성합니다.

두 번째 명령은 Alias.ps1 파일의 별칭을 CurrentUser-CurrentHost 프로필에 추가합니다. 프로필의 경로가 변수에 $Profile 저장됩니다. 이 명령은 cmdlet을 Get-Content 사용하여 Alias.ps1 파일 및 Add-Content cmdlet에서 별칭을 가져와 프로필에 추가합니다. 자세한 내용은 about_Profiles를 참조하세요.

세 번째 및 네 번째 명령은 Alias.ps1 파일의 별칭을 Server01 컴퓨터의 원격 세션에 추가합니다. 세 번째 명령은 cmdlet을 New-PSSession 사용하여 세션을 만듭니다. 네 번째 명령은 cmdlet의 Invoke-Command FilePath 매개 변수를 사용하여 새 세션에서 Alias.ps1 파일을 실행합니다.

매개 변수

-Append

이 cmdlet은 해당 파일의 기존 내용을 덮어쓰지 않고 지정된 파일에 출력을 추가한다는 것을 나타냅니다.

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

-As

출력 형식을 지정합니다. CSV가 기본값입니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • CSV입니다. CSV(쉼표로 구분된 값) 형식입니다.
  • 스크립트. 내보낸 Set-Alias 각 별칭에 대한 명령을 만듭니다. 출력 파일의 이름을 .ps1 파일 이름 확장명으로 지정하는 경우 스크립트로 실행하여 모든 세션에 별칭을 추가할 수 있습니다.
형식:ExportAliasFormat
허용되는 값:Csv, Script
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-Description

내보낸 파일에 대한 설명을 지정합니다. 설명은 헤더 정보에 따라 파일 맨 위에 주석으로 표시됩니다.

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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

파일에 읽기 전용 특성이 설정되어 있더라도 출력 파일을 덮어씁니다.

기본적으로 Export-Alias 읽기 전용 또는 숨겨진 특성이 설정 되거나 NoClobber 매개 변수가 명령에 사용되지 않는 한 경고 없이 파일을 덮어씁니다. NoClobber 매개 변수는 명령에서 둘 다 사용될 때 Force 매개 변수보다 우선합니다.

Force 매개 변수는 숨겨진 특성으로 파일을 강제로 Export-Alias 덮어쓸 수 없습니다.

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

-LiteralPath

출력 파일의 경로를 지정합니다. Path와 달리 LiteralPath 매개 변수의 값은 입력된 대로 정확하게 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 작은따옴표로 묶습니다. 작은따옴표는 PowerShell에 문자를 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

형식:String
별칭:PSPath, LP
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

이름을 내보낼 별칭의 배열로 지정합니다. 와일드카드가 허용됩니다.

기본적으로 Export-Alias 세션 또는 범위의 모든 별칭을 내보냅니다.

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

-NoClobber

이 cmdlet은 Force 매개 변수가 명령에 사용되는 경우에도 파일을 덮어쓰지 못하도록 합니다Export-Alias.

NoClobber 매개 변수를 생략 Export-Alias 하면 파일에 읽기 전용 특성이 설정되지 않는 한 경고 없이 기존 파일을 덮어쓰게 됩니다. NoClobber는 읽기 전용 특성으로 파일을 덮어쓸 수 있는 Export-Alias Force 매개 변수보다 우선합니다.

NoClobber는 Append 매개 변수가 기존 파일에 콘텐츠를 추가하는 것을 방지하지 않습니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

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

-Path

출력 파일의 경로를 지정합니다. 와일드카드를 사용할 수는 있지만 결과 경로 값은 하나의 파일 이름을 도출해야 합니다.

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

-Scope

별칭을 내보낼 범위를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 전역
  • Local
  • 스크립트
  • 현재 범위에 상대적인 숫자입니다(0부터 범위 수까지 0은 현재 범위이고 1은 부모 범위임).

기본값은 Local입니다. 자세한 내용은 about_Scopes 참조하세요.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

AliasInfo

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 별칭을 나타내는 AliasInfo 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Export-Alias

  • 모든 플랫폼:
    • epal
  • 파일로 별칭만 내보낼 수 있습니다.