다음을 통해 공유

Update-List

  • 참조
모듈:
Microsoft.PowerShell.Utility

개체 컬렉션을 포함하는 속성 값에 항목을 추가하고 제거합니다.

구문

Update-List
      [-Add <Object[]>]
      [-Remove <Object[]>]
      [-InputObject <PSObject>]
      [[-Property] <String>]
      [<CommonParameters>]
Update-List
      -Replace <Object[]>
      [-InputObject <PSObject>]
      [[-Property] <String>]
      [<CommonParameters>]

Description

Update-List cmdlet은 개체의 속성 값에 항목을 추가하고 제거한 다음 업데이트된 개체를 반환합니다. 이 cmdlet은 개체 컬렉션을 포함하는 속성을 위해 설계되었습니다.

추가 및 제거 매개 변수는 개별 항목을 추가하고 컬렉션에서 제거합니다. Replace 매개 변수는 전체 컬렉션을 대체합니다.

명령에서 속성을 지정하지 않으면 Update-List 개체를 업데이트하는 대신 업데이트를 설명하는 개체를 반환합니다. Set-* cmdlet과 같은 개체를 변경하는 cmdlet에 업데이트 개체를 제출할 수 있습니다.

이 cmdlet은 업데이트 중인 속성이 Update-List 사용하는 IList 인터페이스를 지원하는 경우에만 . 또한 업데이트를 수락하는 모든 Set-* cmdlet은 IList 인터페이스를 지원해야 합니다. Windows PowerShell과 함께 설치된 핵심 cmdlet은 이 인터페이스를 지원하지 않습니다. cmdlet이 Update-List지원하는지 여부를 확인하려면 cmdlet 도움말 항목을 참조하세요.

예제

예제 1: 속성 값에서 항목 추가 및 제거

PS C:\> Get-MailBox | Update-List -Property aliases -Add "A","B" -Remove "X","Y" | Set-MailBox

이 명령은 A와 B를 추가하고 사서함의 별칭 속성에서 X 및 Y를 제거합니다.

이 명령은 Microsoft Exchange Server의 Get-Mailbox cmdlet을 사용하여 사서함을 가져옵니다. 파이프라인 운영자는 사서함 개체를 Update-List cmdlet으로 보냅니다.

Update-List 명령은 속성 매개 변수를 사용하여 사서함의 별칭 속성이 업데이트되고 있음을 나타내며 추가 및 제거 매개 변수를 사용하여 컬렉션에서 추가 및 제거되는 항목을 지정합니다. 별칭 속성은 Add 및 Remove 메서드가 있는 Microsoft .NET Framework 개체 컬렉션을 저장하므로 Update-List조건을 충족합니다.

Update-List cmdlet은 업데이트된 사서함을 반환합니다. 이 사서함은 사서함을 변경하는 Set-MailBox cmdlet으로 파이프됩니다.

예제 2: 변수의 속성 값에서 항목 추가 및 제거

PS C:\> $M = Get-MailBox
PS C:\> Update-List -InputObject $M -Property aliases -Add "A","B" -Remove "X", "Y" | Set-MailBox

이 명령은 사서함의 별칭 속성 값에 A와 B를 추가하고 X 및 Y를 제거합니다. 이 명령은 약간 다른 형식이지만 이전 명령과 동일한 효과를 냅니다.

이 명령은 Get-MailBox cmdlet을 사용하여 사서함을 가져와서 사서함을 $M 변수에 저장합니다. 이 명령은 Update-ListInputObject 매개 변수를 사용하여 사서함을 지정합니다. InputObject 값은 $M 변수의 사서함입니다. Property 매개 변수를 사용하여 별칭 속성과 추가 지정하고 매개 변수를 제거 별칭 값에서 추가 및 제거되는 항목을 지정합니다.

이 명령은 파이프라인 연산자(|)를 사용하여 업데이트된 사서함 개체를 Set-Mailbox cmdlet으로 보내 사서함을 변경합니다.

예제 3: 속성 값에서 항목 추가 및 제거

PS C:\> Get-MailBox | Set-MailBox -Alias (Update-List -Add "A", "B" -Remove "X","Y")

이 명령은 사서함의 별칭 속성 값에 A와 B를 추가하고 X 및 Y를 제거합니다. 이 명령은 이전 두 명령과 동일한 효과를 가지지만 다른 절차를 사용하여 작업을 수행합니다.

이 명령은 사서함의 별칭 속성을 Set-Mailbox보내기 전에 업데이트하는 대신 Update-List 사용하여 변경 사항을 나타내는 개체를 만듭니다. 그런 다음 Set-Mailbox별칭 매개 변수에 대한 변경 사항을 제출합니다.

이 명령은 Get-MailBox cmdlet을 사용하여 사서함을 가져옵니다. 파이프라인 운영자는 사서함 개체를 Set-Mailbox cmdlet으로 보내 사서함을 변경합니다.

이 명령은 Set-Mailbox별칭 매개 변수를 사용하여 사서함 개체의 별칭 속성을 변경합니다. 별칭 매개 변수의 값은 업데이트를 나타내는 개체를 만드는 Update-List 명령입니다. Update-List 명령은 별칭 매개 변수의 값이 평가되기 전에 실행되도록 괄호로 묶습니다. Set-Mailbox 명령이 완료되면 사서함이 변경됩니다.

예제 4: 속성 컬렉션 바꾸기

PS C:\> Update-List -InputObject $A -Property aliases -Replace "A", "B" | Set-MailBox

이 명령은 Update-List Replace 연산자를 사용하여 $A 개체의 별칭 속성에 있는 컬렉션을 새 컬렉션으로 바꿉니다.

이 명령은 InputObject 매개 변수를 사용합니다. 이 매개 변수는 파이프라인 연산자를 사용하여 $A Update-List전달하는 것과 같습니다.

매개 변수

-Add

컬렉션에 추가할 속성 값을 지정합니다. 컬렉션에 표시할 순서대로 값을 입력합니다.

형식:Object[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

업데이트할 개체를 지정합니다. 업데이트할 개체를 Update-List파이프할 수도 있습니다.

형식:PSObject
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Property

업데이트할 컬렉션을 포함하는 속성을 지정합니다. 이 매개 변수를 생략하면 Update-List 개체를 변경하는 대신 변경 사항을 나타내는 개체를 반환합니다.

형식:String
Position:0
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Remove

컬렉션에서 제거할 속성 값을 지정합니다.

형식:Object[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Replace

새 컬렉션을 지정합니다. 이 매개 변수는 원래 컬렉션의 모든 항목을 이 매개 변수로 지정된 항목으로 바꿉니다.

형식:Object[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

PSObject

업데이트할 개체를 Update-List파이프할 수 있습니다.

출력

Objects or System.Management.Automation.PSListModifier

Update-List 업데이트된 개체를 반환하거나 업데이트 작업을 나타내는 개체를 반환합니다.