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은 출력을 반환하지 않습니다.
PassThru 매개 변수를 사용하는 경우 이 cmdlet은 새 별칭을 나타내는 AliasInfo 개체를 반환합니다.
참고
PowerShell에는 다음 별칭이 포함됩니다.New-Alias
모든 플랫폼:
nal
새 별칭을 만들려면 다음을 사용
Set-Alias
하거나New-Alias
별칭을 변경하려면 .를 사용합니다Set-Alias
. 별칭을 삭제하려면 .를 사용합니다Remove-Alias
.
관련 링크
PowerShell