Update-List

Update-List [-Add <Object[]>] [-Remove <Object[]>] [[-Property] <string>] [-InputObject <psobject>] [<CommonParameters>]

Update-List -Replace <Object[]> [[-Property] <string>] [-InputObject <psobject>] [<CommonParameters>]

Update-List cmdlet은 개체 속성 값의 항목을 추가하거나 제거한 다음 업데이트된 개체를 반환합니다. 이 cmdlet은 개체 컬렉션을 포함하는 속성에 사용됩니다.

Add 및 Remove 매개 변수는 컬렉션의 개별 항목을 추가하거나 제거합니다. Replace 매개 변수는 전체 컬렉션을 교체합니다.

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

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

-Add <Object[]>

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

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

-InputObject <psobject>

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

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

-Property <string>

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

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

-Remove <Object[]>

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

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

-Replace <Object[]>

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

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

<CommonParameters>

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

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

입력

System.Management.Automation.PSObject

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

출력

개체 또는 System.Management.Automation.PSListModifier

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

C:\PS>get-mailbox | update-list -Property aliases -Add "A","B" -Remove "X","Y" | set-mailbox

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

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

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

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

Get-Mailbox에 대한 자세한 내용은 https://go.microsoft.com/fwlink/?LinkId=111536을 참조하십시오.

C:\PS>$m = get-mailbox

C:\PS> update-list -InputObject $m -Property aliases -Add "A","B" -Remove "X", "Y" | set-mailbox

설명
-----------
이 명령은 사서함의 Aliases 속성 값에 A 및 B를 추가하고 X 및 Y를 제거합니다. 이 명령은 형식이 약간 다르기는 하지만 앞의 명령과 동일한 효과를 가지고 있습니다.

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

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

C:\PS>get-mailbox | set-mailbox -alias (update-list -Add "A", "B" -Remove "X","Y")

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

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

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

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

C:\PS>update-list -InputObject $a -Property aliases -replace "A", "B" | set-mailbox

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

이 명령은 InputObject 매개 변수를 사용하는데 이 경우 이 매개 변수를 사용하는 것은 파이프라인 연산자를 사용하여 $a를 Update-List로 전달하는 것과 동일합니다.

Select-Object