다음을 통해 공유


New-Alias

새 별칭을 만듭니다.

구문

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

Description

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

예제

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

New-Alias -Name "List" Get-ChildItem

이 명령은 Get-ChildItem cmdlet을 나타내는 List라는 별칭을 만듭니다.

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

이 명령은 cmdlet을 나타내는 명명된 C 별칭을 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-Location 함수Set-ParentDirectory를 만듭니다. 두 번째 명령은 함수를 호출 Set-ParentDirectory 하는 별칭 .. 을 만드는 데 사용합니다New-Alias. 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

명명된 별칭이 이미 있는 경우처럼 Set-Alias cmdlet이 작동한다는 것을 나타냅니다.

형식: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, 현재 범위는 1 해당 0 부모임).

기본값은 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.