Powershell – Parameter Attribute

Powershell Cmdlet, Function을 이용 하다 보면 명령 뒤의 Parameter를 필수 적으로 입력을 요구 할 때가 있다. 또 명령어 뒤에 -[parameter명] 을 붙히지 않고 공백으로 구분하여 입력 하면 자동으로 순서대로 Parameter를 인식 하는데 이런 동작들은 Cmdlet, Function 내부에 진입 하기 전에 Parameter Attribute 에 의해서 조절 된다.

https://www.goedkoopvliegen.nl/uncategorized/7o1ekqz7vm1

즉 꼭 필요로 하는 Parameter를 Cmdlet 안에서 $null 체크를 하는 것이 아니라 (할 수도 있겠지만), Parameter Attribute 에 의해서 값이 체크 되고 통과 하지 않으면 자동으로 Parameter를 물어 본다.

https://elisabethbell.com/thxqtipco0 예를 들어

https://www.goedkoopvliegen.nl/uncategorized/ero5t7uhb Set-ExecutionPolicy

https://www.mominleggings.com/sp86opiykd3 를 입력 하면 다음과 같이 ExecutionPolicy 를 물어 볼 것이다.

Ordering Tramadol From Mexico PS D:myScripts> Set-ExecutionPolicy cmdlet Set-ExecutionPolicy(명령 파이프라인 위치 1) 다음 매개 변수에 대한 값을 제공하십시오. ExecutionPolicy:

https://giannifava.org/ri4nc2rvv 물론 당연하게 느껴 진다. 실행 정책(Execution Policy)을 설정(Set) 한다고 했는데 어떤 값으로 Set 할지 알려 주지 않았기 때문에 당연히 Cmdlet 이 ExecutionPolicy 값을 요구 한다.

https://www.worldhumorawards.org/uncategorized/21sio5ui9p 이것은 Set-ExecutionPolicy Cmdlet 내부 Process 에 정의 되어 있는 것이 아니고 Parameter Attribute 에 의해서 체크 되고 또 입력이 요구 되는 것이다.

https://musiciselementary.com/2024/03/07/j7cbulbbg 예제로 간단한 스크립트를 작정하면서 어떻게 Parameter Attribute를 사용 하는지 알아 보자.

http://countocram.com/2024/03/07/o8vwann4mtf 다음은 입력한 이름과 일치하는 파일 또는 디렉토리를 찾는 스크립트 Search-Item.ps1 이다.

https://ncmm.org/wr9wlzy1k5z param ($Name) Get-ChildItem -Include $Name -Recurse

https://wasmorg.com/2024/03/07/kksk9nkz63 스크립트를 실행 해 보자. 만약 스크립트를 실행하는 현재 위치, 또는 하위 디렉토리에 test 라는 파일이 있다면 다음과 같이 검색 할 수 있다.

.Search-Item.ps1 -Name test

https://fotballsonen.com/2024/03/07/x2ncr53 test 라는 파일이 존재 하지 않으면 아무 결과도 볼 수 없을 것이고 있다면 다음과 비슷한 결과를 볼 수 있을 것이다.

https://www.jamesramsden.com/2024/03/07/thi8jqt Mode LastWriteTime Length Name ---- ------------- ------ ---- d---- 2010-03-24 오후 3:27 test

https://www.goedkoopvliegen.nl/uncategorized/julw1rfkuo 이번엔 Parameter로 아무 것도 입력 하지 않고 스크립트를 실행 해 보자.

https://www.worldhumorawards.org/uncategorized/gf31qcmou .Search-Item.ps1

아마도 현재 위치를 포함한 하위의 모든 파일, 디렉토리가 나올 것이다. 분명 잘 못된 동작이다.

https://fotballsonen.com/2024/03/07/kvh8z3jg2s 그렇다면 Search-Item.ps1 의 -Name Parameter를 강제로 입력 하도록 하는것이 해결 방법중 하나가 되겠다. 이 때 Parameter Attribute를 유용하게 쓸 수 있다.

Search-Item.ps1을 다음과 같이 고쳐 보자.

param ([Parameter(Mandatory=$true)]$Name) Get-ChildItem -Include $Name -Recurse

Mandatory (필수) Property를 true 로 설정 했다. 즉 $Name Parameter는 필수로 입력 해야 된다는 이야기 이다. 물론 $false로 설정하면 반대의 효과이다.

그리고 또 다시 Parameter를 입력하지 않고 스크립트를 실행 시키면, 의도 대로 Parameter를 요구 한다.

https://asperformance.com/uncategorized/q15eqak3gt PS D:myScripts> .Search-Item.ps1 cmdlet Search-Item.ps1(명령 파이프라인 위치 1) 다음 매개 변수에 대한 값을 제공하십시오. Name:

https://elisabethbell.com/t6kn1j3jko Parameter Attribute 에는 Mandatory 이외에도 몇가지 Property가 더 있는데 다음 링크를 참고 한다.


MSDN – ParamerterAttribute Properties


내가 즐겨 쓰는 Property 로는

HelpMessage

http://countocram.com/2024/03/07/0hpimw1l : 파라메터 설명 넣기

Mandatory

https://wasmorg.com/2024/03/07/fz2o62ra : 필수 Parameter

Position

https://ncmm.org/xttgjzh6 : Parameter 이름을 명시 하지 않을 때 (-Name 과 같은.) Parameter의 위치

ValueFromPipeline

https://www.lcclub.co.uk/51z7da7973v : true로 하면 Pipeline로 받은 값을 해당 Parameter의 입력으로 넣을 수 있다.

https://www.mominleggings.com/okqop1i 이 옵션들을 적당히 사용했을 때 Search-Item.ps1은 다음과 같다.

Search-Item.ps1

http://countocram.com/2024/03/07/hw8nhvlwa4 param ( [Parameter( HelpMessage="Item Name", Mandatory=$true, Position=0, ValueFromPipeline=$true )] $Name, [Parameter( HelpMessage="Base Path", Position=1 )] $BasePath = $(Get-Location) ) Get-ChildItem -Path $BasePath -Include $Name -Recurse