New-Alias

  • 참조
모듈:
Microsoft.PowerShell.Utility

새 별칭을 만듭니다.

Syntax

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에 대한 읽기 전용 별칭 만들기

New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

이 명령은 cmdlet을 나타내는 명명된 C 별칭을 Get-ChildItem 만듭니다. 별칭에 대한 설명인 빠른 wmi 별칭을 만들고 읽기 전용으로 만듭니다. 명령 Get-Alias 의 마지막 줄은 새 별칭을 가져와서 Format-List로 파이프하여 모든 정보를 표시합니다.

매개 변수

-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

명명된 별칭이 이미 있는 경우처럼 Set-Alias cmdlet이 작동한다는 것을 나타냅니다.

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

-Name

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

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

-Option

별칭의 Options 속성 값을 지정합니다. 유효한 값은 다음과 같습니다.

  • None: 별칭에 제약 조건이 없습니다(기본값).
  • ReadOnly: 별칭은 삭제할 수 있지만 Force 매개 변수를 사용하는 경우를 제외하고는 변경할 수 없습니다.
  • Constant: 별칭을 삭제하거나 변경할 수 없습니다.
  • Private: 별칭은 현재 범위에서만 사용할 수 있습니다.
  • AllScope: 별칭이 생성된 새 범위에 복사됩니다.
  • Unspecified: 옵션이 지정되지 않았습니다.

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

세션에서 모든 별칭의 Options 속성을 보려면 .를 입력Get-Alias | Format-Table -Property Name, Options -AutoSize합니다.

Type:ScopedItemOptions
Accepted values:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

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

-Scope

새 별칭의 범위를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Global
  • Local
  • Script
  • 현재 범위에 상대적인 숫자입니다(범위 수까지 0, 현재 범위는 1 해당 0 부모임).

기본값은 Local입니다. 자세한 내용은 about_Scopes 참조하세요.

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

-Value

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

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에는 다음 별칭이 포함됩니다.New-Alias

  • 모든 플랫폼:

    • nal

  • 새 별칭을 만들려면 다음을 사용 Set-Alias 하거나 New-Alias 별칭을 변경하려면 .를 사용합니다 Set-Alias. 별칭을 삭제하려면 .를 사용합니다 Remove-Alias.