Add-Member

사용자가 정의한 사용자 지정 멤버를 Windows PowerShell 개체의 인스턴스에 추가합니다.

구문

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>]

설명

Add-Member cmdlet은 사용자가 정의한 사용자 지정 멤버를 Windows PowerShell 개체의 인스턴스에 추가합니다. AliasProperty, CodeProperty, NoteProperty, ScriptProperty, PropertySet, CodeMethod, MemberSet, ScriptMethod 등의 멤버 유형을 추가할 수 있습니다. Value 매개 변수를 사용하여 멤버 초기 값을 설정합니다. AliasProperty, ScriptProperty, CodeProperty 및 CodeMethod의 경우 SecondValue 매개 변수를 사용하여 추가 정보를 제공할 수 있습니다.

추가 멤버는 Add-Member로 파이프할 개체 또는 InputObject 매개 변수를 사용하여 지정하는 개체의 특정 인스턴스에 추가됩니다. 이러한 추가 멤버는 해당 인스턴스가 있는 동안에만 사용할 수 있습니다. Export-Clixml cmdlet을 사용하여 추가 멤버를 포함한 인스턴스를 파일에 저장할 수 있습니다. 이 파일에 저장된 정보는 Import-Clixml cmdlet에서 개체의 인스턴스를 다시 만드는 데 사용할 수 있습니다.

매개 변수

-Force

이름이 같은 멤버가 이미 있는 경우에도 새 멤버를 추가합니다. 한 유형의 핵심 멤버에는 작동하지 않습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-InputObject <psobject>

새 멤버를 추가할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.

필수 여부	true
위치	named
기본값
파이프라인 입력 적용 여부	true (ByValue)
와일드카드 문자 적용 여부	false

-MemberType <PSMemberTypes>

추가할 멤버의 유형을 지정합니다. 이 매개 변수는 필수 사항입니다.

이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.

-- AliasProperty: 기존 속성의 새 이름을 정의하는 속성입니다.

-- CodeMethod: Microsoft .NET Framework 클래스의 정적 메서드를 참조하는 메서드입니다.

-- CodeProperty: .NET Framework 클래스의 정적 속성을 참조하는 속성입니다.

-- MemberSet: PSBase, PSObject, PSTypeNames와 같은 미리 정의된 속성 및 메서드 컬렉션입니다.

-- Method: 기본 .NET Framework 개체의 메서드입니다.

-- NoteProperty: 정적 값이 포함된 속성입니다.

-- ParameterizedProperty: 매개 변수 및 매개 변수 값을 사용하는 속성입니다.

-- Property: 기본 .NET Framework 개체의 속성입니다.

-- PropertySet: 미리 정의된 개체 속성 컬렉션입니다.

-- ScriptMethod: 해당 값이 스크립트의 출력인 메서드입니다.

-- ScriptProperty: 해당 값이 스크립트의 출력인 속성입니다.

-- All: 모든 멤버 유형을 가져옵니다.

-- Methods: 개체의 모든 메서드 유형(예: method, codemethod, scriptmethod)을 가져옵니다.

-- Properties: 개체의 모든 속성 유형(예: property, codeproperty, aliasproperty, scriptproperty)을 가져옵니다.

모든 개체가 모든 멤버 유형을 포함하는 것은 아닙니다. 개체에 포함되지 않은 멤버 유형을 지정하면 Windows PowerShell에서 오류가 반환됩니다.

Event 멤버 유형은 Add-Member에 사용할 수 없습니다.

필수 여부	true
위치	1
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	true

-Name <string>

추가할 멤버의 이름을 지정합니다.

"Name" 매개 변수 이름을 생략하는 경우 –Name 매개 변수 값은 명령에서 두 번째 명명되지 않은 매개 변수 값이어야 합니다. 그러나 매개 변수 이름을 포함하면 원하는 순서대로 매개 변수를 표시할 수 있습니다.

필수 여부	true
위치	2
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-PassThru

새로 확장된 개체를 파이프라인으로 전달합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-SecondValue <Object>

AliasProperty, ScriptProperty, CodeProperty 또는 CodeMethod 멤버에 대한 선택적 추가 정보를 지정합니다. AliasProperty를 추가할 때 사용하는 경우 이 매개 변수는 데이터 유형이어야 합니다. 지정된 데이터 유형으로의 변환은 AliasProperty 값에 추가됩니다. 예를 들어 문자열 속성의 대체 이름을 제공하는 AliasProperty를 추가할 경우 System.Int32의 SecondValue 매개 변수를 지정하여 해당 AliasProperty를 통해 액세스할 때 문자열 속성 값이 정수로 변환되어야 함을 나타낼 수 있습니다.

SecondValue 매개 변수를 사용하여 ScriptProperty 멤버를 추가할 때 추가 ScriptBlock을 지정할 수 있습니다. 이 경우 Value 매개 변수에 지정된 첫 번째 ScriptBlock은 변수 값을 가져오는 데 사용되고, SecondValue 매개 변수에 지정된 두 번째 ScriptBlock은 변수 값을 설정하는 데 사용됩니다.

필수 여부	false
위치	4
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Value <Object>

추가된 멤버의 초기 값을 지정합니다. AliasProperty, CodeProperty 또는 CodeMethod 멤버를 추가한 경우 SecondValue 매개 변수를 사용하여 선택적으로 추가 정보를 제공할 수 있습니다.

필수 여부	false
위치	3
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력	System.Management.Automation.PSObject 임의의 개체 유형을 Add-Member로 파이프할 수 있습니다.
출력	없음 또는 System.Object PassThru 매개 변수를 사용하는 경우 Add-Member는 새로 확장된 개체를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

PSObject 개체에만 멤버를 추가할 수 있습니다. 개체가 PSObject 개체인지 확인하려면 "is" 연산자를 사용합니다. 예를 들어 $obj 변수에 저장된 개체를 테스트하려면 "$obj -is [PSObject]"를 입력합니다.

MemberType, Name, Value 및 SecondValue 매개 변수의 이름은 선택 사항입니다. 매개 변수 이름을 생략할 경우 명명되지 않은 매개 변수 값은 MemberType, Name, Value, SecondValue의 순서대로 표시해야 합니다. 그러나 매개 변수 이름을 포함하면 원하는 순서대로 매개 변수를 표시할 수 있습니다.

예 1

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으로 보냅니다. 속성이 추가되었다는 출력이 표시됩니다.

예 2

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 속성의 값을 반환합니다.

예 3

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 매개 변수를 명령에 포함하여 확장된 문자열을 변수에 저장해야 합니다. 예의 마지막 명령은 새 속성을 표시합니다.

예 4

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 변수에 저장될 출력으로 강제 반환하도록 지정됩니다.

예 5

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 유형임을 확인합니다.

예 6

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 매개 변수를 사용합니다.

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

참고 항목

개념

Get-Member
Export-Clixml
Import-Clixml