Update-List
Ajoute et supprime des éléments d’une valeur de propriété qui contient une collection d’objets.
Syntaxe
Update-List
[-Add <Object[]>]
[-Remove <Object[]>]
[-InputObject <PSObject>]
[[-Property] <String>]
[<CommonParameters>]Update-List
-Replace <Object[]>
[-InputObject <PSObject>]
[[-Property] <String>]
[<CommonParameters>]Description
L’applet de commande update-List
Le Ajouter et Supprimer des paramètres ajouter des éléments individuels à la collection et les supprimer de la collection. Le paramètre Remplacer remplace la collection entière.
Si vous ne spécifiez pas de propriété dans la commande, Update-List retourne un objet qui décrit la mise à jour au lieu de mettre à jour l’objet. Vous pouvez soumettre l’objet de mise à jour aux applets de commande qui modifient des objets, tels que les applets de commande Set-*.
Cette applet de commande fonctionne uniquement lorsque la propriété mise à jour prend en charge l’interface IList qui Update-List utilise. En outre, les applets de commande Set-* qui acceptent une mise à jour doivent prendre en charge l’interface IList. Les applets de commande principales installées avec Windows PowerShell ne prennent pas en charge cette interface. Pour déterminer si une applet de commande prend en charge update-List, consultez la rubrique d’aide de l’applet de commande.
Exemples
Exemple 1 : Ajouter et supprimer des éléments d’une valeur de propriété
PS C:\> Get-MailBox | Update-List -Property aliases -Add "A","B" -Remove "X","Y" | Set-MailBoxCette commande ajoute A et B et supprime X et Y de la propriété Aliases d’une boîte aux lettres.
La commande utilise l’applet de commande Get-Mailbox de Microsoft Exchange Server pour obtenir la boîte aux lettres.
Un opérateur de pipeline envoie l’objet de boîte aux lettres à l’applet de commande Update-List
La commande Update-List utilise le paramètre Property pour indiquer que la propriété Alias de la boîte aux lettres est mise à jour et utilise la Ajouter et Supprimer des paramètres pour spécifier les éléments ajoutés et supprimés de la collection. La propriété Aliases remplit les conditions de Update-List, car elle stocke une collection d’objets Microsoft .NET Framework qui ont des méthodes Add et Remove.
L’applet de commande Update-List retourne la boîte aux lettres mise à jour, qui est redirigée vers l’applet de commande Set-MailBox, qui modifie la boîte aux lettres.
Exemple 2 : Ajouter et supprimer des éléments d’une valeur de propriété dans une variable
PS C:\> $M = Get-MailBox
PS C:\> Update-List -InputObject $M -Property aliases -Add "A","B" -Remove "X", "Y" | Set-MailBoxCette commande ajoute A et B à la valeur de la propriété Aliases d’une boîte aux lettres et supprime X et Y. Cette commande a le même effet que la commande précédente, bien qu’elle ait un format légèrement différent.
La commande utilise l’applet de commande Get-MailBox
La commande utilise un opérateur de pipeline (|) pour envoyer l’objet de boîte aux lettres mis à jour à l’applet de commande Set-Mailbox, qui modifie la boîte aux lettres.
Exemple 3 : Ajouter et supprimer des éléments d’une valeur de propriété
PS C:\> Get-MailBox | Set-MailBox -Alias (Update-List -Add "A", "B" -Remove "X","Y")Cette commande ajoute A et B à la valeur de la propriété Aliases d’une boîte aux lettres et supprime X et Y. Cette commande a le même effet que les deux commandes précédentes, mais elle utilise une procédure différente pour effectuer la tâche.
Au lieu de mettre à jour la propriété Alias de la boîte aux lettres avant de l’envoyer à Set-Mailbox, cette commande utilise update-List pour créer un objet qui représente la modification. Ensuite, il envoie la modification au paramètre alias de Set-Mailbox .
La commande utilise l’applet de commande Get-MailBox
La commande utilise le paramètre alias
Exemple 4 : Remplacer une collection de propriétés
PS C:\> Update-List -InputObject $A -Property aliases -Replace "A", "B" | Set-MailBoxCette commande utilise l’opérateur Replace de Update-List pour remplacer la collection dans la propriété Aliases de l’objet dans $A par une nouvelle collection.
Cette commande utilise le paramètre InputObject
Paramètres
-Add
Spécifie les valeurs de propriété à ajouter à la collection. Entrez les valeurs dans l’ordre dans lequel elles doivent apparaître dans la collection.
| Type: | Object[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InputObject
Spécifie les objets à mettre à jour. Vous pouvez également diriger l’objet à mettre à jour vers Update-List .
| Type: | PSObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Property
Spécifie la propriété qui contient la collection en cours de mise à jour. Si vous omettez ce paramètre, Update-List retourne un objet qui représente la modification au lieu de modifier l’objet.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Remove
Spécifie les valeurs de propriété à supprimer de la collection.
| Type: | Object[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Replace
Spécifie une nouvelle collection. Ce paramètre remplace tous les éléments de la collection d’origine par les éléments spécifiés par ce paramètre.
| Type: | Object[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Vous pouvez diriger les objets à mettre à jour vers Update-List .
Sorties
Objects or System.Management.Automation.PSListModifier
update-List retourne l’objet mis à jour ou retourne un objet qui représente l’action de mise à jour.