다음을 통해 공유


Set-Alias

현재 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 매개 변수를 사용합니다.

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

$Parameters = @{
    Name        =  'loc'
    Value       =  (Get-Location)
    Option      =  'ReadOnly'
    Description =  'Displays the current directory'
    Force       = $true
    PassThru    = $true
}
Set-Alias @Parameters | 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 매개 변수를 사용하여 별칭이 npnotepad.exe연결되어 있음을 표시합니다.

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

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

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

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

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

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.

예제 6: 기존 별칭에 대한 업데이트 옵션

이 예제에서는 Option 매개 변수를 사용하여 여러 옵션을 할당하는 방법을 보여줍니다.

이전 예제에서 계속 별칭 Go 을 및 PrivateReadOnly 설정합니다.

Set-Alias -Name Go -Option ReadOnly, Private

별칭이 Go 이미 있어야 합니다. 명령을 실행한 후에는 Force 매개 변수를 사용하지 않고 별칭을 변경할 수 없으며 현재 scope만 사용할 수 있습니다.

매개 변수

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

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

  • AllScope - 별칭이 생성된 새 범위에 복사됩니다.
  • Constant - 변경하거나 삭제할 수 없습니다.
  • None - 옵션을 설정하지 않고 기본값입니다.
  • Private- 별칭은 현재 scope만 사용할 수 있습니다.
  • ReadOnly - Force 매개 변수를 사용하지 않는 한 변경하거나 삭제할 수 없습니다.
  • Unspecified

이러한 값은 플래그 기반 열거형으로 정의됩니다. 이 매개 변수를 사용하여 여러 값을 결합하여 여러 플래그를 설정할 수 있습니다. 값은 Option 매개 변수에 값 배열 또는 해당 값의 쉼표로 구분된 문자열로 전달할 수 있습니다. cmdlet은 이진 OR 연산을 사용하여 값을 결합합니다. 값을 배열로 전달하는 것이 가장 간단한 옵션이며 값에 탭 완성을 사용할 수도 있습니다.

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

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

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

  • Global
  • Local
  • Private
  • Numbered scopes
  • Script
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

이 cmdlet에 개체를 파이프할 수 없습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

AliasInfo

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 별칭을 나타내는 AliasInfo 개체를 반환합니다.

참고

PowerShell에는 에 대한 Set-Alias다음 별칭이 포함되어 있습니다.

  • 모든 플랫폼:
    • sal

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

별칭을 만들려면 cmdlet 또는 New-AliasSet-Alias 사용합니다. PowerShell 6에서 별칭을 삭제하려면 cmdlet을 Remove-Alias 사용합니다. Remove-Item 는 이전 버전의 PowerShell로 만든 스크립트와 같은 이전 버전과의 호환성을 위해 허용됩니다. 와 같은 Remove-Item -Path Alias:aliasname명령을 사용합니다.

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

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