이 항목에서는 cmdlet의 매개 변수를 선언하기 전에 이해해야 하는 기본 정보를 제공합니다.
cmdlet 클래스 내에서 cmdlet의 매개 변수를 선언하려면 각 매개 변수를 나타내는 공용 속성을 정의한 다음 각 속성에 하나 이상의 매개 변수 특성을 추가합니다. Windows PowerShell 런타임은 매개 변수 특성을 사용하여 속성을 cmdlet 매개 변수로 식별합니다. Parameter 특성을 선언하기 위한 기본 구문은 [Parameter()] 입니다.
다음은 필수 매개 변수로 정의된 속성의 예입니다.
[Parameter(Position = 0, Mandatory = true)]
public string UserName
{
get { return userName; }
set { userName = value; }
}
private string userName;
다음은 매개 변수에 대해 기억해야 할 몇 가지 사항입니다.
매개 변수는 명시적으로 public으로 표시되어야 합니다. public으로 표시되지 않은 매개 변수는 기본적으로 internal로 설정되며 Windows PowerShell 런타임에서 찾을 수 없습니다.
매개 변수 유효성 검사를 개선하려면 매개 변수를 Microsoft .NET Framework 형식으로 정의해야 합니다. 예를 들어 값 집합 중 하나의 값으로 제한된 매개 변수는 열거형 형식으로 정의되어야 합니다. URI(Uniform Resource Identifier) 값을 갖는 매개 변수는 System.Uri형식이어야 합니다.
자유 형식 텍스트 속성을 제외한 모든 속성에 대해 기본 문자열 매개 변수를 사용하지 않습니다.
원하는 수의 매개 변수 집합에 매개 변수를 추가할 수 있습니다. 매개 변수 집합에 대한 자세한 내용은 Cmdlet 매개 변수 집합을 참조하세요.
또한 Windows PowerShell 모든 cmdlet에서 자동으로 사용할 수 있는 일반 매개 변수 집합을 제공합니다. 이러한 매개 변수 및 해당 별칭에 대한 자세한 내용은 Cmdlet 일반 매개 변수 를 참조하세요.
참고 항목
Writing a Windows PowerShell Cmdlet(Windows PowerShell Cmdlet 작성)