about_Command_Syntax
업데이트 날짜: 2014년 5월
적용 대상: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0
여기에 소개를 삽입합니다.
항목
about_Command_Syntax
간단한 설명
Windows PowerShell®에 사용되는 구문 다이어그램에 대해 설명합니다.
자세한 설명
Get-Help 및 Get-Command cmdlet은 명령을 올바르게 생성하도록 도와주는 구문 다이어그램을 표시합니다. 이 항목에서는 구문 다이어그램의 해석 방법을 설명합니다.
구문 다이어그램
명령 구문 다이어그램에 나오는 각 단락은 올바른 형태의 명령을 나타냅니다.
명령을 생성하려면 왼쪽에서 오른쪽으로 이동하면서 구문 다이어그램을 살펴봅니다. 선택적 매개 변수 중에서 선택하고 자리 표시자 값을 제공합니다.
Windows PowerShell은 구문 다이어그램에서 다음 표기법을 사용합니다.
<command-name> -<Required Parameter Name> <Required Parameter Value>
[-<Optional Parameter Name> <Optional Parameter Value>]
[-<Optional Switch Parameters>]
[-<Optional Parameter Name>] <Required Parameter Value>
다음은 New-Alias cmdlet에 대한 구문입니다.
New-Alias [-Name] <string> [-Value] <string> [-Description <string>]
[-Force] [-Option {None | ReadOnly | Constant | Private | AllScope}]
[-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
구문은 가독성을 위해 대문자로 표시되지만 Windows PowerShell은 대/소문자를 구분하지 않습니다.
구문 다이어그램에는 다음과 같은 요소가 있습니다.
명령 이름
------------
명령은 항상 New-Alias와 같은 명령 이름으로 시작합니다. 명령 이름 또는 해당 별칭(예: Get-Command의 경우 "gcm")을 입력합니다.
매개 변수
----------
명령의 매개 변수는 명령이 수행하는 작업을 결정하는 옵션입니다. 일부 매개 변수는 명령에 대한 사용자 입력인 "값"을 받습니다.
예를 들어 Get-Help 명령에는 도움말이 표시되는 항목의 이름을 지정할 수 있는 Name 매개 변수가 있습니다. 항목 이름은 Name 매개 변수의 값입니다.
Windows PowerShell 명령에서 매개 변수 이름은 항상 하이픈으로 시작합니다. 하이픈은 명령의 항목이 매개 변수 이름임을 Windows PowerShell에 알려줍니다.
예를 들어 New-Alias의 Name 매개 변수를 사용하려면 다음을 입력합니다.
-Name
매개 변수는 필수 또는 옵션일 수 있습니다. 구문 다이어그램에서 선택적 항목은 대괄호([ ])로 묶어야 합니다.
매개 변수에 대한 자세한 내용은 about_Parameters를 참조하세요.
매개 변수 값
----------------
매개 변수 값은 매개 변수가 받는 입력입니다. Windows PowerShell은 Microsoft .NET Framework를 기반으로 하므로 매개 변수 값이 .NET 형식으로 구문 다이어그램에 표시됩니다.
예를 들어 Get-Help의 Name 매개 변수는 텍스트 문자열(예: 한 단어 또는 큰따옴표로 묶은 여러 단어)인 String 값을 사용합니다.
[-Name] <string>
매개 변수 값의 .NET 형식은 명령에 입력하는 리터럴이 아닌, 값에 대한 자리 표시자임을 나타내기 위해 중괄호(< >)로 묶습니다.
매개 변수를 사용하려면 .NET 형식 자리 표시자를 .NET 형식이 지정된 개체로 바꿉니다.
예를 들어 Name 매개 변수를 사용하려면 "-Name" 뒤에 다음과 같은 문자열을 입력합니다.
-Name MyAlias
값이 없는 매개 변수
-------------------------
일부 매개 변수는 입력을 허용하지 않으므로 매개 변수 값이 없습니다. 값이 없는 매개 변수는 설정/해제 스위치와 같은 작동하므로 "스위치 매개 변수"라고 합니다. 명령에 포함(on)하거나 명령에서 생략(off)합니다.
스위치 매개 변수를 사용하려면 하이픈을 입력한 후 매개 변수 이름에 입력하면 됩니다.
예를 들어 New-Alias cmdlet의 WhatIf 매개 변수를 사용하려면 다음을 입력합니다.
-WhatIf
매개 변수 집합
--------------
명령의 매개 변수는 매개 변수 집합에 나열됩니다. 매개 변수 집합은 구문 다이어그램의 단락처럼 보입니다.
New-Alias cmdlet에는 하나의 매개 변수 집합이 있지만 많은 cmdlet에는 여러 매개 변수 집합이 있습니다. 일부 cmdlet 매개 변수는 매개 변수 집합마다 고유하며 어떤 cmdlet 매개 변수는 여러 매개 변수 집합에 나타납니다.
각 매개 변수 집합은 유효한 명령의 형식을 나타냅니다. 매개 변수 집합에는 하나의 명령에서 함께 사용할 수 있는 매개 변수만 포함됩니다. 매개 변수를 동일한 명령에서 사용할 수 없으면 별도의 매개 변수 집합에 나타납니다.
예를 들어 Get-Random cmdlet에는 다음과 같은 매개 변수 집합이 있습니다.
Get-Random [[-Maximum] <Object>] [-Minimum <Object>] [-SetSeed <int>]
[<CommonParameters>]
Get-Random [-InputObject] <Object[]> [-Count <int>] [-SetSeed <int>]
[<CommonParameters>]
난수를 반환하는 첫 번째 매개 변수 집합에는 Minimum 및 Maximum 매개 변수가 있습니다. 개체의 집합에서 임의로 선택된 개체를 반환하는 두 번째 매개 변수 집합에는 InputObject 및 Count 매개 변수가 포함됩니다. 두 매개 변수 집합에는 Set-Seed 매개 변수 및 일반 매개 변수가 있습니다.
이러한 매개 변수 집합은 InputObject 및 Count 매개 변수를 동일한 명령에서 사용할 수 있지만 Maximum 및 Count 매개 변수는 동일한 명령에서 사용할 수 없음을 나타냅니다.
해당 매개 변수 집합에 있는 매개 변수를 사용하여 사용하려는 매개 변수 집합을 지정합니다.
그러나 모든 cmdlet에는 기본 매개 변수 집합도 있습니다. 기본 매개 변수 집합은 매개 변수 집합마다 고유한 매개 변수를 지정하지 않을 때 사용됩니다. 예를 들어 매개 변수 없이 Get-Random을 사용하는 경우 Windows PowerShell에서는 사용자가 Number 매개 변수 집합을 사용하고 있다고 가정하고 난수를 반환합니다.
각 매개 변수 집합에서 매개 변수는 위치 순서로 표시됩니다. 명령에서 매개 변수의 순서는 선택적 매개 변수 이름을 생략할 때만 중요합니다. 매개 변수 이름을 생략하면 Windows PowerShell은 위치 및 형식에 따라 매개 변수에 값을 할당합니다. 매개 변수 위치에 대한 자세한 내용은 about_Parameters를 참조하세요.
구문 다이어그램의 기호
구문 다이어그램에는 명령 이름, 명령 매개 변수 및 매개 변수 값이 표시됩니다. 또한 기호를 사용하여 유효한 명령의 생성 방법을 나타냅니다.
구문 다이어그램은 다음 기호를 사용합니다.
--하이픈(-)은 매개 변수 이름을 나타냅니다. 구문 다이어그램에 표시되는 것처럼 명령에서 공백 없이 매개 변수 이름 바로 앞에 하이픈을 입력합니다.
예를 들어 New-Alias의 Name 매개 변수를 사용하려면 다음을 입력합니다.
-Name
-- 꺾쇠 괄호(<>)는 자리 표시자 텍스트를 나타냅니다. 명령에 꺾쇠 괄호 또는 자리 표시자 텍스트를 입력하지 말고 대신 해당 항목을 설명하는 내용으로 바꿉니다.
꺾쇠 괄호는 매개 변수가 사용하는 값의 .NET 형식을 식별하는 데 사용됩니다. 예를 들어 New-Alias cmdlet의 Name 매개 변수를 사용하려면 <string>을 한 단어 또는 큰따옴표로 묶은 단어 그룹인 문자열로 바꿉니다.
-- 대괄호([ ])는 선택적 항목을 나타냅니다. 매개 변수 및 해당 값이 선택적이거나 필수 매개 변수의 이름이 선택적일 수 있습니다.
예를 들어 New-Alias의 Description 매개 변수와 해당 값은 둘 다 선택적이므로 대괄호로 묶습니다.
[-Description <string>]
또한 Name 매개 변수 값(<문자열>)은 필수이지만 매개 변수 이름 "Name"은 선택적임을 나타내는 데도 대괄호를 사용합니다.
[-Name] <string>
-- .NET 형식에 오른쪽 및 왼쪽 대괄호([])를 추가하면 매개 변수가 해당 형식의 값을 하나 또는 여러 개 허용할 수 있다는 것을 나타냅니다. 쉼표로 구분된 목록으로 값을 입력합니다.
예를 들어 New-Alias cmdlet의 Name 매개 변수는 문자열을 하나만 사용하지만 Get-Process의 Name 매개 변수는 하나 또는 여러 개의 문자열을 사용할 수 있습니다.
New-Alias [-Name] <string>
New-Alias -Name MyAlias
Get-Process [-Name] <string[]>
Get-Process -Name Explorer, Winlogon, Services
-- 중괄호({})는 매개 변수의 유효한 값 집합인 "열거형"을 나타냅니다.
중괄호로 묶은 값은 세로 막대(|)로 구분됩니다. 이러한 막대는 "단독 또는" 옵션을 나타냅니다. 즉, 중괄호 안에 표시된 값 집합에서 값을 하나만 선택할 수 있음을 의미합니다.
예를 들어 New-Alias cmdlet에 대한 구문에는 Option 매개 변수에 대한 다음 값 열거형이 포함됩니다.
-Option {None | ReadOnly | Constant | Private | AllScope}
중괄호와 세로 막대는 ReadOnly 또는 AllScope와 같이 Option 매개 변수에 대해 나열된 값 중 하나를 선택할 수 있음을 나타냅니다.
-Option ReadOnly
옵션 항목
대괄호([])는 선택적 항목을 묶는 데 사용됩니다. 예를 들어 New-Alias cmdlet 구문 설명에서 Scope 매개 변수는 선택적입니다. 매개 변수 이름 및 형식을 대괄호로 묶어 구문에서 이러한 매개 변수가 선택적임을 나타냅니다.
[-Scope <string>]
다음 두 예제는 New-Alias cmdlet의 올바른 사용을 보여 줍니다.
New-Alias -Name utd -Value Update-TypeData
New-Alias -Name utd -Value Update-TypeData -Scope global
해당 매개 변수의 값이 필수여도 매개 변수 이름은 선택적일 수 있습니다. 이 예제의 New-Alias cmdlet에서 볼 수 있듯이 매개 변수 형식이 아닌 매개 변수 이름을 중괄호로 구문에 선택적 매개 변수임을 표시할 수 있습니다.
[-Name] <string> [-Value] <string>
다음 명령은 New-Alias cmdlet을 올바르게 사용합니다. 명령은 동일한 결과를 생성합니다.
New-Alias -Name utd -Value Update-TypeData
New-Alias -Name utd Update-TypeData
New-Alias utd -Value Update-TypeData
New-Alias utd Update-TypeData
매개 변수 이름이 입력한 대로 문에 포함되지 않을 경우 Windows PowerShell은 인수의 위치를 사용하여 매개 변수에 값을 대입하려고 합니다.
다음 예제는 완전하지 않습니다.
New-Alias utd
이 cmdlet에는 Name 및 Value 매개 변수 모두에 대한 값이 필요합니다.
구문 예제에서 이름 지정 및 .NET Framework 형식으로의 캐스팅에도 대괄호가 사용됩니다. 이 컨텍스트에서 대괄호가 사용되어도 요소가 옵션이라는 의미는 아닙니다.
키워드
about_Symbols
about_Punctuation
about_Help_Syntax
참고 항목
about_Parameters
Get-Command
Get-Help