Add-Member

Add-Member [-MemberType] {<AliasProperty> | <CodeProperty> | <Property> | <NoteProperty> | <ScriptProperty> | <Properties> | <PropertySet> | <Method> | <CodeMethod> | <ScriptMethod> | <Methods> | <ParameterizedProperty> | <MemberSet> | <Event> | <All>} [-Name] <string> -InputObject <psobject> [[-Value] <Object>] [[-SecondValue] <Object>] [-Force] [-PassThru] [<CommonParameters>]

C:\PS>$a = (get-childitem)[0]

C:\PS> $a | add-member -membertype noteproperty -name Status -value done

C:\PS> $a | get-member -type noteproperty

   TypeName: System.IO.DirectoryInfo

Name          MemberType   Definition
----          ----------   ----------
PSChildName   NoteProperty System.String PSChildName=Co
PSDrive       NoteProperty System.Management.Automation
PSIsContainer NoteProperty System.Boolean PSIsContainer
PSParentPath  NoteProperty System.String PSParentPath=M
PSPath        NoteProperty System.String PSPath=Microso
PSProvider    NoteProperty System.Management.Automation
Status        NoteProperty System.String Status=done

설명
-----------
이들 명령은 Get-ChildItem이 반환하는 DirectoryInfo 개체에 Status 메모 속성을 추가하고 여기에 "done" 값을 할당합니다. 

첫 번째 명령은 Get-Childitem이 반환하는 첫 번째 개체(인덱스 0)를 가져옵니다.

두 번째 명령은 메모 속성을 추가합니다.

세 번째 명령은 파이프라인 연산자(|)를 사용하여 업데이트된 개체를 Get-Member cmdlet으로 보냅니다. 속성이 추가되었다는 출력이 표시됩니다.

C:\PS>$a = (get-childitem)[0]

C:\PS> $a | add-member -membertype aliasproperty -name FileLength -value Length 

C:\PS> $a.filelength

설명
-----------
이들 명령은 Get-ChildItem이 반환하는 DirectoryInfo 개체에 FileLength 별칭 속성을 추가합니다. 새 속성은 Length 속성에 대한 별칭입니다. 

첫 번째 명령은 Get-Childitem이 반환하는 첫 번째 개체(인덱스 0)를 가져옵니다.

두 번째 명령은 별칭 속성을 추가합니다.

세 번째 명령은 새 FileLength 속성의 값을 반환합니다.

C:\PS>$a = "a string"

C:\PS> $a = $a | add-member -membertype noteproperty -name StringUse -value Display -passthru

C:\PS> $a.StringUse

설명
-----------
이들 명령은 StringUse 속성을 문자열에 추가합니다. 문자열은 PSObject 개체가 아니므로 PassThru 매개 변수를 명령에 포함하여 확장된 문자열을 변수에 저장해야 합니다. 예의 마지막 명령은 새 속성을 표시합니다.

C:\PS>$a = "this is a string"

C:\PS> $a = add-member -inputobject $a -membertype scriptmethod -name words `
-value {$this.split()} -passthru

C:\PS> $a.words()

설명
-----------
이들 명령은 문자열 개체에 스크립트 메서드를 추가합니다. 스크립트 메서드는 System.String .NET Framework Class Library 클래스의 Split() 메서드를 제공하여 이름이 문자열 개체의 "Words"에 해당하는 메서드를 호출하는 방식으로 문자열의 개별 단어를 쉽게 반환할 수 있도록 합니다. PassThru 매개 변수는 Add-Member에서 확장된 문자열 개체를 $a 변수에 저장될 출력으로 강제 반환하도록 지정됩니다.

C:\PS>$event = get-eventlog -logname system -newest 1

C:\PS> $event.TimeWritten | get-member

C:\PS> add-member -inputobject $event -membertype aliasproperty -name When `
-value TimeWritten -secondvalue System.String

C:\PS> $event.When | get-member

설명
-----------
이들 명령은 Get-EventLog cmdlet이 반환하는 EventLogEntry 개체에 AliasProperty를 추가합니다. AliasProperty는 개체의 TimeWritten 속성에 대한 별칭으로, AliasProperty의 이름은 "When"입니다. SecondValue 매개 변수는 AliasProperty를 사용하여 액세스한 경우 속성 값이 System.String 유형으로 변환되도록 지정하는 데 사용됩니다. TimeWritten 속성은 DateTime 개체입니다.

첫 번째 명령은 Get-EventLog cmdlet을 사용하여 시스템 이벤트 로그에서 가장 최근 이벤트를 검색하고 이를 $event 변수에 저장합니다. 

두 번째 명령은 이 이벤트의 TimeWritten 속성에 액세스한 다음 이 속성을 Get-Member cmdlet으로 파이프하여 해당 속성이 DateTime 유형임을 확인합니다. 그런 다음 Add-Member를 사용하여 $event 변수에 저장된 EventLogEntry 개체의 인스턴스에 AliasProperty 멤버를 추가합니다. Name 매개 변수는 새 멤버의 이름을 "When"으로 설정하는 데 사용되고, Value 매개 변수는 새 멤버를 TimeWritten 속성의 별칭으로 지정하는 데 사용합니다. SecondValue 매개 변수는 이 새 멤버를 사용할 경우 반환하는 값이 원래 System.DateTime 유형에서 System.String 유형으로 캐스팅됨을 나타내는 데 사용됩니다. 

세 번째 명령은 새 멤버에 액세스한 다음 이 멤버를 Get-Member cmdlet으로 파이프하여 해당 멤버가 System.String 유형임을 확인합니다.

C:\PS>function Copy-Property ($From, $To)

{
  foreach ($p in Get-Member -InputObject $From -MemberType Property)
  {
     Add-Member -InputObject $To -MemberType NoteProperty -Name $p.Name 
     -Value $From.$($p.Name) -Force

     $To.$($p.Name) = $From.$($p.Name)
   }
}

설명
-----------
이 함수는 한 개체의 모든 속성을 다른 개체로 복사합니다.

함수의 첫 번째 명령에서는 함수 이름을 선언하고 매개 변수를 나열합니다. 

Foreach 루프는 Get-Member cmdlet을 사용하여 From 개체의 각 속성을 가져옵니다. Foreach 루프 내부의 명령은 각 속성에 대해 차례로 수행됩니다.

Add-Member 명령은 From 개체의 속성을 To 개체에 NoteProperty로 추가합니다. 이 명령은 이름이 같은 멤버를 추가할 수 있도록 Force 매개 변수를 사용합니다.

함수의 마지막 명령은 새 속성에 원래 속성과 동일한 이름을 지정합니다.