New-Alias
새 별칭을 만듭니다.
구문
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
New-Alias cmdlet은 현재 Windows PowerShell 세션에서 새 별칭을 만듭니다. New-Alias 사용하여 만든 별칭은 세션을 종료하거나 Windows PowerShell을 닫은 후에 저장되지 않습니다. Export-Alias cmdlet을 사용하여 별칭 정보를 파일에 저장할 수 있습니다. 나중에 Import-Alias 사용하여 저장된 별칭 정보를 검색할 수 있습니다.
예제
예제 1: cmdlet에 대한 별칭 만들기
PS C:\> New-Alias -Name "List" Get-ChildItem이 명령은 list라는 별칭을 만들어 Get-ChildItem cmdlet을 나타냅니다.
예제 2: cmdlet에 대한 읽기 전용 별칭 만들기
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *이 명령은 Get-WmiObject cmdlet을 나타내는 W라는 별칭을 만듭니다. 별칭에 대한 설명인 빠른 wmi 별칭을 만들고 읽기 전용으로 만듭니다. 명령의 마지막 줄은 Get-Alias 사용하여 새 별칭을 가져와서 Format-List 파이프하여 모든 정보를 표시합니다.
매개 변수
-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 속성 값을 지정합니다. 유효한 값은 다음과 같습니다.
- 없음: 별칭에 제약 조건이 없음(기본값)
- ReadOnly: 별칭은 삭제할 수 있지만 Force 매개 변수를 사용하는 경우를 제외하고는 변경할 수 없습니다.
- 상수: 별칭을 삭제하거나 변경할 수 없습니다.
- 프라이빗: 별칭은 현재 범위에서만 사용할 수 있습니다.
- AllScope: 별칭이 생성된 새 범위에 복사됩니다.
- 지정되지 않음: 옵션이 지정되지 않았습니다.
세션에 있는 모든 별칭의 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
새 별칭의 범위를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 글로벌
- 현지
- 각본
- 현재 범위에 상대적인 숫자입니다(범위 수까지 0, 여기서 0은 현재 범위이고 1은 부모).
로컬이 기본값입니다. 자세한 내용은 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 or System.Management.Automation.AliasInfo
Passthru 매개 변수를 사용하는 경우 New-Alias 새 별칭을 나타내는 System.Management.Automation.AliasInfo 개체를 생성합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.
참고
새 별칭을 만들려면 Set-Alias 또는 New-Alias를 사용합니다. 별칭을 변경하려면 Set-Alias사용합니다. 별칭을 삭제하려면 Remove-Item을 사용합니다.