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 是針對包含 物件集合的屬性所設計。

Add 和 Remove 參數會將個別專案新增至集合並從集合中移除這些專案。 Replace 參數會取代整個集合。

如果您未在命令中指定屬性，Update-List 會傳回描述更新的物件，而不是更新物件。 您可以將更新物件提交至變更物件的 Cmdlet，例如 Set-* Cmdlet。

只有當要更新的屬性支援 Update-List 使用的 IList 介面時，這個 Cmdlet 才有效。 此外，任何接受更新的 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，並從信箱的 Aliases 屬性中移除 X 和 Y。

此命令會使用 Microsoft Exchange Server Get-Mailbox Cmdlet 來取得信箱。 管線運算符會將信箱物件傳送至 Update-List Cmdlet。

Update-List 命令會使用 Property 參數來指出信箱的 Aliases 屬性正在更新，並且會使用 Add 和 Remove 參數來指定從集合新增和移除的專案。 Aliases 屬性滿足 update-List的條件，因為它會儲存具有 Add 和 Remove 方法之 .NET Framework 物件的 Microsoft集合。

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 新增至信箱的 Aliases 屬性值，並移除 X 和 Y。此命令的效果與上一個命令相同，不過其格式稍有不同。

命令會使用 Get-MailBox Cmdlet 來取得信箱，並將信箱儲存在 $M 變數中。 此命令會使用 Update-List 的 InputObject 參數來指定信箱。 InputObject 的值是$M變數中的信箱。 它會使用 Property 參數來指定 Aliases 屬性和 Add 和 Remove 參數，以指定要新增至別名並從別名值中移除的專案。

此命令會使用管線運算符 （|） 將更新的信箱物件傳送至變更信箱的 Set-Mailbox Cmdlet。

範例 3：從屬性值新增和移除專案

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

此命令會將 A 和 B 新增至信箱的 Aliases 屬性值，並移除 X 和 Y。此命令的效果與先前的兩個命令相同，但會使用不同的程式來執行工作。

此命令會使用 Update-List 來建立代表變更的物件，而不是在將信箱傳送至 set-Mailbox之前更新信箱的 Aliases 屬性。 然後，它會將變更提交至 set-Mailbox的 Alias 參數。

此命令會使用 Get-MailBox Cmdlet 來取得信箱。 管線操作員會將信箱物件傳送至 Set-Mailbox Cmdlet，以變更信箱。

此命令會使用 set-Mailbox 的 Alias 參數來變更信箱物件的 Aliases 屬性。 Alias 參數的值是 Update-List 命令，可建立代表更新的物件。 Update-List 命令會以括弧括住，以確保它會在評估 Alias 參數的值之前執行。 當 set-Mailbox 命令 完成時，信箱就會變更。

範例 4：取代屬性集合

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

此命令會使用 update-List Replace 運算符，將 $A 中 物件的 Aliases 屬性中的集合取代為新的集合。

此命令會使用 InputObject 參數，在此情況下，相當於使用管線運算符將 $A傳遞至 update-List 。

參數

-Add

指定要加入至集合的屬性值。 輸入值，順序應該出現在集合中。

類型:	Object[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定要更新的物件。 您也可以使用管線將物件更新至 Update-List。

類型:	PSObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Property

指定包含要更新之集合的屬性。 如果您省略此參數，Update-List 會傳回代表變更的物件，而不是變更物件。

類型:	String
Position:	0
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Remove

指定要從集合中移除的屬性值。

類型:	Object[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Replace

指定新的集合。 此參數會將原始集合中的所有專案取代為此參數所指定的專案。

類型:	Object[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

PSObject

您可以使用管線將物件傳送至 Update-List。

輸出

Objects or System.Management.Automation.PSListModifier

Update-List 會傳回更新的物件，或傳回代表更新動作的物件。

相關連結

• Format-List
• Select-Object