다음을 통해 공유

New-Alias

  • 참조
모듈:
Microsoft.PowerShell.Utility

새 별칭을 만듭니다.

구문

New-Alias
   [-Name] <String>
   [-Value] <String>
   [-Description <String>]
   [-Option <ScopedItemOptions>]
   [-PassThru]
   [-Scope <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-Alias cmdlet은 현재 PowerShell 세션에서 새 별칭을 만듭니다. New-Alias 사용하여 만든 별칭은 세션을 종료하거나 PowerShell을 닫은 후에 저장되지 않습니다. Export-Alias cmdlet을 사용하여 별칭 정보를 파일에 저장할 수 있습니다. 나중에 Import-Alias 사용하여 저장된 별칭 정보를 검색할 수 있습니다.

예제

예제 1: cmdlet에 대한 별칭 만들기

New-Alias -Name "List" Get-ChildItem

이 명령은 list라는 별칭을 만들어 Get-ChildItem cmdlet을 나타냅니다.

예제 2: cmdlet에 대한 읽기 전용 별칭 만들기

이 명령은 C cmdlet을 나타내는 Get-ChildItem 별칭을 만듭니다. 별칭에 대한 "빠른 gci 별칭"에 대한 설명을 만들고 읽기 전용으로 만듭니다.

New-Alias -Name "C" -Value Get-ChildItem -Description "Quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : Quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

Get-Alias 파이프된 Format-List 명령은 새 별칭에 대한 모든 정보를 표시합니다.

예제 3: 매개 변수를 사용하여 명령에 대한 별칭 만들기

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

첫 번째 명령은 Set-ParentDirectory 사용하여 작업 위치를 부모 디렉터리로 설정하는 함수 Set-Location만듭니다. 두 번째 명령은 New-Alias 사용하여 .. 함수를 호출하는 Set-ParentDirectory 별칭을 만듭니다. Value 매개 변수에는 cmdlet, 함수 또는 실행 가능한 값이 필요하므로 매개 변수를 사용하는 별칭을 만드는 사용자 지정 함수를 만들어야 합니다. 별칭 .. 실행하면 현재 위치가 부모 디렉터리로 변경됩니다.

매개 변수

-Confirm

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

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

-Description

별칭에 대한 설명을 지정합니다. 모든 문자열을 입력할 수 있습니다. 설명에 공백이 포함된 경우 따옴표로 묶습니다.

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

-Force

명명된 별칭이 이미 있는 경우 cmdlet이 Set-Alias 같은 역할을 했음을 나타냅니다.

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

-Name

새 별칭을 지정합니다. 별칭에 영숫자를 사용할 수 있지만 첫 번째 문자는 숫자가 될 수 없습니다.

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

-Option

별칭의 Options 속성 값을 지정합니다. 유효한 값은 다음과 같습니다.

  • None: 별칭에 제약 조건이 없습니다(기본값).
  • ReadOnly: 별칭은 삭제할 수 있지만 Force 매개 변수를 사용하는 경우를 제외하고는 변경할 수 없습니다.
  • Constant: 별칭을 삭제하거나 변경할 수 없습니다.
  • Private: 별칭은 현재 범위에서만 사용할 수 있습니다.
  • AllScope: 별칭이 생성된 새 범위에 복사됩니다.
  • Unspecified: 옵션이 지정되지 않았습니다.

이러한 값은 플래그 기반 열거형으로 정의됩니다. 이 매개 변수를 사용하여 여러 값을 결합하여 여러 플래그를 설정할 수 있습니다. 값은 Option 매개 변수에 값 배열 또는 해당 값의 쉼표로 구분된 문자열로 전달될 수 있습니다. cmdlet은 이진 OR 연산을 사용하여 값을 결합합니다. 값을 배열로 전달하는 것이 가장 간단한 옵션이며 값에 대한 탭 완성을 사용할 수도 있습니다.

세션에 있는 모든 별칭의 Options 속성을 보려면 Get-Alias | Format-Table -Property Name, Options -AutoSize입력합니다.

형식:ScopedItemOptions
허용되는 값:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

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

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

-Scope

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

  • Global
  • Local
  • Script
  • 현재 범위에 상대적인 숫자입니다(범위 수를 0부터 0 현재 범위이고 1 부모인 경우).

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

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

-Value

별칭을 지정하는 cmdlet 또는 명령 요소의 이름을 지정합니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

입력

None

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

출력

None

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

AliasInfo

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

참고

PowerShell에는 New-Alias다음과 같은 별칭이 포함되어 있습니다.

  • 모든 플랫폼:

    • nal

  • 새 별칭을 만들려면 Set-Alias 또는 New-Alias사용합니다. 별칭을 변경하려면 Set-Alias사용합니다. 별칭을 삭제하려면 Remove-Alias사용합니다.