Update-List

Modul:

Microsoft.PowerShell.Utility Module

Elemeket ad hozzá egy objektumgyűjteményt tartalmazó tulajdonságértékhez, és eltávolítja az elemeket.

Syntax

AddRemoveSet (Alapértelmezett)

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

ReplaceSet

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

Description

A Update-List parancsmag elemeket ad hozzá egy objektum tulajdonságértékéhez, és eltávolítja az elemeket, majd visszaadja a frissített objektumot. Ez a parancsmag objektumgyűjteményeket tartalmazó tulajdonságokhoz készült.

A Add and Remove parameters add individual items to and remove them from the collection. A Replace paraméter a teljes gyűjteményt lecseréli.

Ha nem ad meg tulajdonságot a parancsban, Update-List az objektum frissítése helyett egy, a frissítést leíró objektumot ad vissza. A frissítési objektumot elküldheti az objektumokat módosító parancsmagoknak, például a Set-* parancsmagoknak.

Ez a parancsmag csak akkor működik, ha a frissített tulajdonság támogatja az Update-List által IList-felületet. Emellett a frissítést elfogadó Set-* parancsmagoknak támogatniuk kell az IList-felületet. A Windows PowerShell-lel telepített alapvető parancsmagok nem támogatják ezt a felületet. Annak megállapításához, hogy egy parancsmag támogatja-e Update-List, tekintse meg a parancsmag súgótémakörét.

Példák

1. példa: Elemek hozzáadása és eltávolítása tulajdonságértékből

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

Ez a parancs hozzáadja az A és B elemet, és eltávolítja az X és Y elemet egy postaláda Aliases tulajdonságából.

A parancs a Microsoft Exchange Server Get-Mailbox parancsmagját használja a postaláda lekéréséhez. A folyamatkezelő elküldi a postaláda-objektumot a Update-List parancsmagnak.

A Frissítési lista parancs a Tulajdonság paraméter használatával jelzi, hogy a postaláda Aliases tulajdonsága frissítve van, és a hozzáadása és -paraméterek eltávolítása paranccsal adja meg a gyűjteményből felvett és eltávolított elemeket. Az Aliasok tulajdonság megfelel Update-Listfeltételeinek, mivel a Microsoft .NET-keretrendszer olyan objektumgyűjteményét tárolja, amelyek hozzáadási és eltávolítási metódusokkal rendelkeznek.

A Update-List parancsmag visszaadja a frissített postaládát, amely a postaládát módosító Set-MailBox parancsmagra van állítva.

2. példa: Elemek hozzáadása és eltávolítása egy változó tulajdonságértékéből

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

Ez a parancs hozzáadja az A és B értéket egy postaláda Aliases tulajdonságához, és eltávolítja az X és az Y értéket. Ez a parancs ugyanazzal a hatással rendelkezik, mint az előző parancs, bár kissé eltérő formátummal rendelkezik.

A parancs a Get-MailBox parancsmagot használja a postaláda lekéréséhez, és menti a postaládát a $M változóba. Ez a parancs a Update-List InputObject paraméterét használja a postaláda megadásához. Az InputObject értéke a $M változó postaládája. A Tulajdonság paraméter használatával adja meg az Aliasok tulajdonságot, valamint az Add and Remove parameters to specify the items to added to and remove of the value of Aliases.

A parancs egy folyamatkezelővel (|) küldi el a frissített postaláda-objektumot a Set-Mailbox parancsmagra, amely módosítja a postaládát.

3. példa: Elemek hozzáadása és eltávolítása tulajdonságértékből

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

Ez a parancs hozzáadja az A és B értéket egy postaláda Aliases tulajdonságához, és eltávolítja az X és az Y értéket. Ez a parancs ugyanazzal a hatással rendelkezik, mint a két előző parancs, de a feladat végrehajtásához más eljárást használ.

Ahelyett, hogy frissítené a postaláda Aliases tulajdonságát, mielőtt Set-Mailbox-ra küldené, ez a parancs Update-List használatával hoz létre egy, a módosítást jelképező objektumot. Ezután elküldi a módosítást Set-MailboxAlias paraméterének.

A parancs a Get-MailBox parancsmagot használja a postaláda lekéréséhez. A folyamatkezelő elküldi a postaláda-objektumot a Set-Mailbox parancsmagnak, amely módosítja a postaládákat.

A parancs a Set-MailboxAlias paraméterét használja a postaláda-objektum Aliases tulajdonságának módosításához. A Alias paraméter értéke egy Update-List parancs, amely létrehoz egy, a frissítést jelképező objektumot. A Update-List parancs zárójelek közé van állítva, hogy a Alias paraméter értékének kiértékelése előtt fusson. Amikor a Set-Mailbox parancs befejeződik, a postaláda megváltozik.

4. példa: Tulajdonsággyűjtemény cseréje

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

Ez a parancs a Update-List Csere operátorával lecseréli a gyűjteményt a $A objektum Aliases tulajdonságában lévő gyűjtemény új gyűjteményre.

Ez a parancs a InputObject paramétert használja, amely ebben az esetben egyenértékű egy folyamatkezelővel, amely $A ad át Update-List.

Paraméterek

-Add

Megadja a gyűjteményhez hozzáadni kívánt tulajdonságértékeket. Adja meg az értékeket a gyűjteményben megjelenítendő sorrendben.

Paramétertulajdonságok

Típus:	Object[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

AddRemoveSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-InputObject

Megadja a frissíteni kívánt objektumokat. Az objektumot frissítheti Frissítési lista.

Paramétertulajdonságok

Típus:	PSObject
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Property

Megadja a frissíteni kívánt gyűjteményt tartalmazó tulajdonságot. Ha kihagyja ezt a paramétert, Update-List az objektum módosítása helyett egy olyan objektumot ad vissza, amely a módosítást jelöli.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	0
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Remove

Megadja a gyűjteményből eltávolítandó tulajdonságértékeket.

Paramétertulajdonságok

Típus:	Object[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

AddRemoveSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Replace

Új gyűjteményt ad meg. Ez a paraméter az eredeti gyűjtemény összes elemét lecseréli a paraméter által megadott elemekre.

Paramétertulajdonságok

Típus:	Object[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ReplaceSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSObject

A frissítendő objektumokat Frissítési lista.

Kimenetek

Objects or System.Management.Automation.PSListModifier

Frissítési lista a frissített objektumot adja vissza, vagy egy, a frissítési műveletet jelképező objektumot ad vissza.

Kapcsolódó hivatkozások

• Formátumlista
• Objekt-kiválasztás