항목
about_Command_Syntax
간단한 설명
도움말에서 Windows PowerShell 구문에 사용되는 표기법에 대해 설명합니다.
자세한 설명
Get-Help cmdlet은 cmdlet에 대한 매개 변수 사용법을 표시합니다. Get-Help cmdlet은 다음 특수
기호를 사용합니다.
꺾쇠괄호(<>)는 자리 표시자 텍스트를 나타냅니다.
대괄호([])는 선택적 항목을 나타내고,
중괄호({})는 여러 값 중 선택을 나타냅니다.
일부 cmdlet에는 매개 변수가 두 개 이상 있으며 개별 매개 변수 집합에서 몇 가지 매개 변수를 공유할 수
있습니다. Get-Help cmdlet은 cmdlet에 대한 모든 매개 변수 집합을 표시합니다.
매개 변수 설명과 매개 변수 특성 테이블에서 매개 변수에 대한 추가 정보를 찾아볼 수 있습니다. 매개
변수에 대한 전체 정보를 보려면 Get-Help의 Full 또는 Parameter 매개 변수를 사용하십시오.
구문
Windows PowerShell cmdlet 도움말, 도움말 항목 및 기타 설명서의 구문 설명에서는
cmdlet에 대해 다음 표기법을 사용합니다.
<cmdlet name> -<Required Parameter name> <Required parameter Value>
[-<Optional Parameter name> <Optional Parameter Value>]
[-<Optional Switch Parameter>]
[-<Optional Parameter Name>] <Required parameter Value>
다음은 New-Alias cmdlet의 구문입니다.
New-Alias [-Force] [-PassThru] [-Scope <string>]
[-Option {None | ReadOnly | Constant | Private | AllScope}]
[-Description <string>] [-Name] <string> [-Value] <string>
[-confirm] [-whatif] [<CommonParameters>]
구문은 읽기 쉽도록 대문자로 표시되어 있지만 Windows Powershell은 대/소문자를 구분하지 않습니다.
매개 변수는 순서대로 나타납니다. 매개 변수의 순서는 매개 변수 이름이 선택적인 경우에만 중요합니다.
cmdlet을 사용할 때 매개 변수 이름을 지정하지 않으면 위치와 유형에 따라 값이 매개 변수에
할당됩니다.
매개 변수 이름 앞에는 하이픈(-)이 있습니다. 스위치 매개 변수는 값 유형 없이 나타납니다. 기타 매개
변수는 필요한 인수의 Microsoft .NET Framework 유형 또는 가능한 값의 열거와 함께 나타납니다. .NET
Framework 유형에 대한 자세한 내용은 https://go.microsoft.com/fwlink/?LinkId=143682
를 참조하십시오.
꺾쇠괄호(<>)는 자리 표시자 텍스트를 나타냅니다. 이 텍스트는
항목 유형(예: 문자열 또는 Process 개체)을 설명합니다. 하나 이상의 일반 매개 변수에 대한 자리
표시자일 수도 있습니다.
대괄호([])는 선택적 항목을 나타냅니다. 매개 변수가 선택적이거나 필수 매개 변수의 이름이 선택적일 수
있습니다. 스위치 매개 변수는 항상 선택적입니다.
중괄호({})는 열거 값을 묶는 데 사용됩니다. New-Alias cmdlet의 예에서는 Option 매개 변수에 나열된
값이 있을 수 있습니다.
선택적 항목
대괄호([])는 선택적 항목을 묶는 데 사용됩니다. 예를 들어, 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 유형에 캐스팅하는 데도 대괄호가 사용됩니다. 이
컨텍스트에서 대괄호는 요소가 선택적임을 나타내지 않습니다.
배열 인수
대괄호는 구문 설명에서 배열을 나타내는 데도 사용됩니다. 다음 예에서는 Restart-Service
cmdlet의 구문을 보여 줍니다.
Restart-Service [-Name] <string[]> [-Include <string[]>]
[-Exclude <string[]>] [-Force] [-PassThru] [-Confirm] [-WhatIf]
[<CommonParameters>]
Name 매개 변수에는 인수가 필요합니다. 특히 서비스 이름을 다시 시작해야 합니다. 다음 예와 같이 이
매개 변수는 쉼표로 구분된 서비스 목록을 사용할 수 있습니다.
Restart-Service RasAuto, RasMan, RemoteAccess
참고 항목
Get-Help