Set-Alias

모듈:

Microsoft.PowerShell.Utility

현재 PowerShell 세션에서 cmdlet 또는 기타 명령에 대한 별칭을 만들거나 변경합니다.

Syntax

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

Description

cmdlet은 Set-Alias 함수, 스크립트, 파일 또는 기타 실행 파일과 같은 cmdlet 또는 명령에 대한 별칭을 만들거나 변경합니다. 별칭은 cmdlet 또는 명령을 참조하는 대체 이름입니다. 예를 들어 는 sal cmdlet의 Set-Alias 별칭입니다. 자세한 내용은 about_Aliases를 참조하세요.

cmdlet에는 여러 별칭이 있을 수 있지만 별칭은 하나의 cmdlet에만 연결할 수 있습니다. 를 사용하여 Set-Alias 기존 별칭을 다른 cmdlet에 다시 할당하거나 설명과 같은 별칭의 속성을 변경할 수 있습니다.

에 의해 Set-Alias 생성되거나 변경된 별칭은 영구적이지 않으며 현재 PowerShell 세션 중에만 사용할 수 있습니다. PowerShell 세션이 닫혀 있으면 별칭이 제거됩니다.

예제

예제 1: cmdlet에 대한 별칭 Create

이 명령은 현재 PowerShell 세션에서 cmdlet에 대한 별칭을 만듭니다.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

cmdlet은 Set-Alias 현재 PowerShell 세션에서 별칭을 만듭니다. Name 매개 변수는 별칭의 이름 를 list지정합니다. Value 매개 변수는 별칭이 실행되는 cmdlet을 지정합니다.

별칭을 실행하려면 PowerShell 명령줄에 를 입력 list 합니다.

예제 2: 기존 별칭을 다른 cmdlet에 다시 할당

이 명령은 기존 별칭을 다시 할당하여 다른 cmdlet을 실행합니다.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

cmdlet은 Get-AliasName 매개 변수를 사용하여 별칭을 list 표시합니다. list 별칭은 cmdlet과 Get-ChildItem 연결됩니다. 별칭이 list 실행되면 현재 디렉터리의 항목이 표시됩니다.

cmdlet은 Set-AliasName 매개 변수를 사용하여 별칭을 list 지정합니다. Value 매개 변수는 별칭을 cmdlet에 Get-Location 연결합니다.

cmdlet은 Get-AliasName 매개 변수를 사용하여 별칭을 list 표시합니다. list 별칭은 cmdlet과 Get-Location 연결됩니다. 별칭이 list 실행되면 현재 디렉터리의 위치가 표시됩니다.

예제 3: 읽기 전용 별칭 Create 및 변경

이 명령은 읽기 전용 별칭을 만듭니다. 읽기 전용 옵션을 사용하면 별칭을 의도하지 않게 변경할 수 없습니다. 읽기 전용 별칭을 변경하거나 삭제하려면 Force 매개 변수를 사용합니다.

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

cmdlet은 Set-Alias 현재 PowerShell 세션에서 별칭을 만듭니다. Name 매개 변수는 별칭의 이름 를 loc지정합니다. Value 매개 변수는 별칭이 Get-Location 실행되는 cmdlet을 지정합니다. Option 매개 변수는 ReadOnly 값을 지정합니다. PassThru 매개 변수는 별칭 개체를 나타내고 개체를 파이프라인 아래로 cmdlet으로 Format-List 보냅니다. Format-List 는 모든 속성 이 표시되도록 별표(*)와 함께 Property 매개 변수를 사용합니다. 예제 출력은 해당 속성의 부분 목록을 보여줍니다.

별칭은 loc 두 개의 매개 변수를 추가하여 변경됩니다. 설명 은 별칭의 용도를 설명하는 텍스트를 추가합니다. 별칭이 읽기 전용이므로 Force 매개 변수가 필요합니다 loc . Force 매개 변수를 사용하지 않으면 변경이 실패합니다.

예제 4: 실행 파일에 별칭 Create

이 예제에서는 로컬 컴퓨터의 실행 파일에 대한 별칭을 만듭니다.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

cmdlet은 Set-Alias 현재 PowerShell 세션에서 별칭을 만듭니다. Name 매개 변수는 별칭의 이름 를 np지정합니다. Value 매개 변수는 경로 및 애플리케이션 이름 C:\Windows\notepad.exe지정합니다. cmdlet은 Get-AliasName 매개 변수를 사용하여 별칭이 notepad.exe와 연결되어 있음을 np 표시합니다.

별칭을 실행하려면 PowerShell 명령줄에 를 입력 np 하여 notepad.exe엽니다.

예제 5: 매개 변수가 있는 명령에 대한 별칭 Create

이 예제에서는 매개 변수를 사용하여 명령에 별칭을 할당하는 방법을 보여 줍니다.

와 같은 Set-Locationcmdlet에 대한 별칭을 만들 수 있습니다. 와 같은 Set-Location -Path C:\Windows\System32매개 변수와 값을 사용하여 명령에 대한 별칭을 만들 수 없습니다. 명령의 별칭을 만들려면 명령이 포함된 함수를 만든 다음 함수의 별칭을 만듭니다. 자세한 내용은 about_Functions 참조하세요.

PS> Function CD32 {Set-Location -Path C:\Windows\System32}

PS> Set-Alias -Name Go -Value CD32

라는 CD32 함수가 만들어집니다. 함수는 Path 매개 변수와 함께 cmdlet을 사용하여 Set-Location디렉터리 C:\Windows\System32를 지정합니다.

cmdlet은 Set-Alias 현재 PowerShell 세션에서 함수에 대한 별칭을 만듭니다. Name 매개 변수는 별칭의 이름 를 Go지정합니다. Value 매개 변수는 함수의 이름 를 CD32지정합니다.

별칭을 실행하려면 PowerShell 명령줄에 를 입력 Go 합니다. 함수가 CD32 실행되고 디렉터리 C:\Windows\System32로 변경됩니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Force 매개 변수를 사용하여 Option 매개 변수가 ReadOnly로 설정된 별칭을 변경하거나 삭제합니다.

Force 매개 변수는 Option 매개 변수가 상수로 설정된 별칭을 변경하거나 삭제할 수 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

새 별칭의 이름을 지정합니다. 별칭 이름에는 영숫자 문자가 포함될 수 있습니다. 별칭 이름은 숫자(예: 123)일 수 없습니다.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Option

별칭의 Option 속성 값을 설정합니다. ReadOnly 및 Constant와 같은 값은 의도하지 않은 변경으로부터 별칭을 보호합니다. 세션에 있는 모든 별칭의 Option 속성을 보려면 를 입력합니다 Get-Alias | Format-Table -Property Name, Options -Autosize.

이 매개 변수에 허용되는 값은 다음과 같습니다.

• AllScope 별칭은 생성된 모든 새 범위에 복사됩니다.
• 상수 변경하거나 삭제할 수 없습니다.
• 없음 옵션을 설정하지 않고 가 기본값입니다.
• 개인 별칭은 현재 scope만 사용할 수 있습니다.
• ReadonlyForce 매개 변수를 사용하지 않는 한 변경하거나 삭제할 수 없습니다.
• Unspecified

Type:	ScopedItemOptions
Accepted values:	AllScope, Constant, None, Private, ReadOnly, Unspecified
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

별칭을 나타내는 개체를 반환합니다. 와 같은 Format-List 형식 cmdlet을 사용하여 개체를 표시합니다. 기본적으로 는 Set-Alias 출력을 생성하지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

이 별칭이 유효한 범위를 지정합니다. 기본값은 Local입니다. 자세한 내용은 about_Scopes 참조하세요.

허용되는 값은 다음과 같습니다.

• 전역
• 로컬
• 프라이빗
• 번호가 매겨진 범위
• 스크립트

Type:	String
Accepted values:	Global, Local, Private, Numbered scopes, Script
Position:	Named
Default value:	Local
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

별칭이 실행되는 cmdlet 또는 명령의 이름을 지정합니다. Value 매개 변수는 별칭의 Definition 속성입니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

None

Set-Alias 는 파이프라인의 입력을 허용하지 않습니다.

출력

None or System.Management.Automation.AliasInfo

PassThru 매개 변수 Set-Alias 를 사용하는 경우 별칭을 나타내는 System.Management.Automation.AliasInfo 개체를 생성합니다. 그렇지 않으면 는 출력을 Set-Alias 생성하지 않습니다.

참고

PowerShell에는 각 PowerShell 세션에서 사용할 수 있는 기본 제공 별칭이 포함되어 있습니다. cmdlet은 Get-Alias PowerShell 세션에서 사용할 수 있는 별칭을 표시합니다.

새 별칭을 만들려면 또는 New-Alias을 사용합니다Set-Alias. 별칭을 제거하려면 cmdlet을 Remove-Item 사용합니다. Remove-Item -Path Alias:aliasname)을 입력합니다.

각 PowerShell 세션에서 사용할 수 있는 별칭을 만들려면 PowerShell 프로필에 추가합니다. 자세한 내용은 about_Profiles를 참조하세요.

별칭은 내보내기 및 가져오기를 수행하여 다른 PowerShell 세션에서 저장하고 다시 사용할 수 있습니다. 별칭을 파일에 저장하려면 를 사용합니다 Export-Alias. 저장된 별칭을 새 PowerShell 세션에 추가하려면 를 사용합니다 Import-Alias.

관련 링크

• about_Aliases
• about_Functions
• about_Profiles
• about_Scopes
• Export-Alias
• Get-Alias
• Import-Alias
• New-Alias
• Remove-Item