Sdílet prostřednictvím

Update-List

  • Reference
Modul:
Microsoft.PowerShell.Utility

Přidá položky do a odebere položky z hodnoty vlastnosti, která obsahuje kolekci objektů.

Syntaxe

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

Description

Rutina Update-List přidá položky do a odebere položky z hodnoty vlastnosti objektu a pak vrátí aktualizovaný objekt. Tato rutina je určená pro vlastnosti, které obsahují kolekce objektů.

Parametry Přidat a Odebrat přidávají jednotlivé položky a odebírají je z kolekce. Parametr Replace nahradí celou kolekci.

Pokud v příkazu nezadáte vlastnost, Update-List vrátí objekt, který místo aktualizace objektu popisuje aktualizaci. Aktualizační objekt můžete odeslat do rutin, které mění objekty, jako jsou rutiny Set-*.

Tato rutina funguje pouze v případě, že aktualizovaná vlastnost podporuje rozhraní IList, které Update-List používá. Všechny rutiny Set-*, které přijímají aktualizaci, musí také podporovat rozhraní IList. Základní rutiny nainstalované v prostředí Windows PowerShell toto rozhraní nepodporují. Pokud chcete zjistit, jestli rutina podporuje Update-List, přečtěte si téma nápovědy k rutině.

Příklady

Příklad 1: Přidání a odebrání položek z hodnoty vlastnosti

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

Tento příkaz přidá A a B a odebere X a Y z vlastnosti Aliases poštovní schránky.

Příkaz používá rutinu Get-Mailbox z Microsoft Exchange Serveru k získání poštovní schránky. Operátor kanálu odešle objekt poštovní schránky do rutiny Update-List.

Příkaz update-list používá parametr Vlastnost k označení, že se aktualizuje vlastnost Aliases poštovní schránky a používá Přidat a Odebrat parametry k určení položek, které se přidávají a odebírají z kolekce. Vlastnost Aliases splňuje podmínky Update-List, protože ukládá kolekci objektů rozhraní Microsoft .NET Framework, které mají metody Add and Remove.

Rutina Update-List vrátí aktualizovanou poštovní schránku, která se předá rutině Set-MailBox, která poštovní schránku změní.

Příklad 2: Přidání a odebrání položek z hodnoty vlastnosti v proměnné

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

Tento příkaz přidá A a B k hodnotě vlastnosti Aliases poštovní schránky a odebere X a Y. Tento příkaz má stejný účinek jako předchozí příkaz, i když má trochu jiný formát.

Příkaz používá rutinu Get-MailBox k získání poštovní schránky a uloží poštovní schránku do proměnné $M. Tento příkaz používá parametr InputObject Update-List k určení poštovní schránky. Hodnota InputObject je poštovní schránka v proměnné $M. Pomocí parametru vlastnost určuje vlastnost Aliases a parametr Add a Remove k určení položek přidaných do a odebraných z hodnoty aliasů.

Příkaz používá operátor kanálu (|) k odeslání aktualizovaného objektu poštovní schránky do rutiny Set-Mailbox, která poštovní schránku změní.

Příklad 3: Přidání a odebrání položek z hodnoty vlastnosti

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

Tento příkaz přidá A a B k hodnotě vlastnosti Aliases poštovní schránky a odebere X a Y. Tento příkaz má stejný účinek jako dva předchozí příkazy, ale k provedení úkolu používá jiný postup.

Místo aktualizace vlastnosti Aliases poštovní schránky před odesláním do Set-Mailboxtento příkaz používá Update-List k vytvoření objektu, který představuje změnu. Potom odešle změnu do parametru alias Set-Mailbox.

Příkaz používá k získání poštovní schránky rutinu Get-MailBox. Operátor kanálu odešle objekt poštovní schránky do rutiny Set-Mailbox, která změní poštovní schránky.

Příkaz používá Alias parametr Set-Mailbox ke změně vlastnosti Aliases objektu poštovní schránky. Hodnota parametru Alias je příkaz Update-List, který vytvoří objekt představující aktualizaci. Příkaz Update-List je uzavřený v závorkách, aby se zajistilo, že se spustí před vyhodnocením hodnoty parametru Alias. Po dokončení příkazu Set-Mailbox se poštovní schránka změní.

Příklad 4: Nahrazení kolekce vlastností

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

Tento příkaz používá operátor Replace Update-List nahradit kolekci ve vlastnosti Aliases objektu v $A novou kolekcí.

Tento příkaz používá parametr InputObject, který v tomto případě odpovídá použití operátoru kanálu k předání $A Update-List.

Parametry

-Add

Určuje hodnoty vlastností, které se mají přidat do kolekce. Zadejte hodnoty v pořadí, v jakém by se měly v kolekci objevit.

Typ:Object[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje objekty, které se mají aktualizovat. Objekt, který se má aktualizovat, můžete také převést naUpdate-List .

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Property

Určuje vlastnost, která obsahuje kolekci, která se aktualizuje. Pokud tento parametr vynecháte, Update-List vrátí objekt, který představuje změnu namísto změny objektu.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Remove

Určuje hodnoty vlastností, které se mají z kolekce odebrat.

Typ:Object[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Replace

Určuje novou kolekci. Tento parametr nahradí všechny položky v původní kolekci položkami zadanými tímto parametrem.

Typ:Object[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Objekty, které chcete aktualizovat, můžete formovat naUpdate-List .

Výstupy

Objects or System.Management.Automation.PSListModifier

aktualizační seznam vrátí aktualizovaný objekt nebo vrátí objekt, který představuje akci aktualizace.