새 별칭을 만듭니다.

구문

New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

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

매개 변수

-Description <string>

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

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Force

이름이 지정된 별칭이 이미 있는 경우 이 옵션을 설정하면 set-alias처럼 작동합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Name <string>

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

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Option <ScopedItemOptions>

별칭에 대한 선택적 속성을 하나 이상 설정합니다. 유효한 값은 다음과 같습니다.

-- None: 옵션을 설정하지 않습니다(기본값).

-- ReadOnly: Force 매개 변수를 사용하지 않으면 별칭을 변경할 수 없습니다.

-- Constant: Force 매개 변수를 사용해도 별칭을 변경할 수 없습니다.

-- Private: Scope 매개 변수에서 지정한 범위 내에서만 별칭을 사용할 수 있습니다. 다른 모든 범위에서는 표시되지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PassThru

새 별칭을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Scope <string>

새 별칭의 범위를 지정합니다. 유효한 값은 "Global", "Local", "Script" 또는 현재 범위와 관련된 수(0부터 범위의 수까지, 여기서 0은 현재 범위이고 1은 그 상위 범위)입니다. "Local"이 기본값입니다. 자세한 내용은 about_Scopes를 참조하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Value <string>

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

필수 여부

true

위치

2

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

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 매개 변수를 사용하는 경우 New-Alias는 새 별칭을 나타내는 System.Management.Automation.AliasInfo 개체를 생성합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

새 별칭을 만들려면 Set-Alias나 New-Alias를 사용하십시오. 별칭을 변경하려면 Set-Alias을 사용하십시오. 별칭을 삭제하려면 Remove-Item을 사용하십시오.

예 1

C:\PS>new-alias list get-childitem

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






예 2

C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly

C:\PS> get-alias -name w | format-list *

설명
-----------
이 명령은 "w"라는 별칭을 만들어 Get-WMIObject cmdlet을 나타냅니다. 별칭에 대해 "quick wmi alias"라는 설명을 만들고 읽기 전용으로 설정합니다. 명령의 마지막 줄은 Get-Alias를 사용하여 새 별칭을 가져오고 이를 Format-List로 파이프하여 그에 대한 모든 정보를 표시합니다.






참고 항목




목차