다음을 통해 공유


Cmdlet 매개 변수를 선언하는 방법

다음 예제에서는 명명된 위치, 필수, 선택 사항 및 매개 변수를 [switch] 선언하는 방법을 보여 줍니다. 이러한 예제에서는 매개 변수 별칭을 정의하는 방법도 보여 줍니다.

명명된 매개 변수를 선언하는 방법

  • 다음 코드와 같이 public 속성을 정의합니다. 매개 변수 특성을 추가할 때 특성에서 키워드를 Position 생략합니다.

    [Parameter()]
    public string UserName
    {
      get { return userName; }
      set { userName = value; }
    }
    private string userName;
    

매개 변수 특성에 대한 자세한 내용은 매개 변수 특성 선언을 참조하세요.

위치 매개 변수를 선언하는 방법

  • 다음 코드와 같이 public 속성을 정의합니다. 매개 변수 특성을 추가할 때 키워드를 Position 인수 위치로 설정합니다. 값이 0이면 첫 번째 위치가 표시됩니다.

    [Parameter(Position = 0)]
    public string UserName
    {
      get { return userName; }
      set { userName = value; }
    }
    private string userName;
    

매개 변수 특성에 대한 자세한 내용은 매개 변수 특성 선언을 참조하세요.

필수 매개 변수를 선언하는 방법

  • 다음 코드와 같이 public 속성을 정의합니다. 매개 변수 특성을 추가할 때 키워드trueMandatory .로 설정합니다.

    [Parameter(Position = 0, Mandatory = true)]
    public string UserName
    {
      get { return userName; }
      set { userName = value; }
    }
    private string userName;
    

매개 변수 특성에 대한 자세한 내용은 매개 변수 특성 선언을 참조하세요.

선택적 매개 변수를 선언하는 방법

  • 다음 코드와 같이 public 속성을 정의합니다. Parameter 특성을 추가할 때 키워드를 생략합니다 Mandatory .

    [Parameter(Position = 0)]
    public string UserName
    {
      get { return userName; }
      set { userName = value; }
    }
    private string userName;
    

매개 변수를 선언하는 [switch] 방법

  • Public 속성을 System.Management.Automation.SwitchParameter 형식으로 정의한 다음 매개 변수 특성을 선언합니다.

    [Parameter(Position = 1)]
    public SwitchParameter GoodBye
    {
      get { return goodbye; }
      set { goodbye = value; }
    }
    private bool goodbye;
    

매개 변수 특성에 대한 자세한 내용은 매개 변수 특성 선언을 참조하세요.

별칭을 사용하여 매개 변수를 선언하는 방법

  • 다음 코드와 같이 public 속성을 정의합니다. 매개 변수의 별칭을 나열하는 별칭 특성을 추가합니다. 이 예제에서는 동일한 매개 변수에 대해 세 개의 별칭이 정의됩니다. 첫 번째 별칭은 바로 가기를 제공합니다. 두 번째 및 세 번째 별칭은 다양한 시나리오에 사용할 수 있는 이름을 제공합니다.

    [Alias("UN","Writer","Editor")]
    [Parameter()]
    public string UserName
    {
      get { return userName; }
      set { userName = value; }
    }
    private string userName;
    

별칭 특성에 대한 자세한 내용은 별칭 특성 선언을 참조하세요.

또한 참조하십시오

System.Management.Automation.SwitchParameter

매개 변수 특성 선언

별칭 특성 선언

Windows PowerShell Cmdlet 작성