Update-List

Modul:

Microsoft.PowerShell.Utility Module

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

Syntax

AddRemoveSet (Výchozí)

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

ReplaceSet

Update-List
    [[-Property] <String>]
    -Replace <Object[]>
    [-InputObject <PSObject>]
    [<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 do kolekce a odebírají je z ní. 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.

Vlastnosti parametru

Typ:	Object[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AddRemoveSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

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

Vlastnosti parametru

Typ:	PSObject
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Remove

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

Vlastnosti parametru

Typ:	Object[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AddRemoveSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Replace

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

Vlastnosti parametru

Typ:	Object[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ReplaceSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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.

Související odkazy

• Seznam formátů
• Vybrat-Objekt