Add-Member

Add-Member [-MemberType] {<AliasProperty> | <CodeProperty> | <Property> | <NoteProperty> | <ScriptProperty> | <Properties> | <PropertySet> | <Method> | <CodeMethod> | <ScriptMethod> | <Methods> | <ParameterizedProperty> | <MemberSet> | <Event> | <All>} [-Name] <string> -InputObject <psobject> [[-Value] <Object>] [[-SecondValue] <Object>] [-Force] [-PassThru] [<CommonParameters>]

C:\PS>$a = (get-childitem)[0]

C:\PS> $a | add-member -membertype noteproperty -name Status -value done

C:\PS> $a | get-member -type noteproperty

   TypeName: System.IO.DirectoryInfo

Name          MemberType   Definition
----          ----------   ----------
PSChildName   NoteProperty System.String PSChildName=Co
PSDrive       NoteProperty System.Management.Automation
PSIsContainer NoteProperty System.Boolean PSIsContainer
PSParentPath  NoteProperty System.String PSParentPath=M
PSPath        NoteProperty System.String PSPath=Microso
PSProvider    NoteProperty System.Management.Automation
Status        NoteProperty System.String Status=done

Description
-----------
Ces commandes ajoutent la propriété de note Status à un objet DirectoryInfo retourné par Get-ChildItem et lui attribuent la valeur « done ». 

La première commande obtient le premier objet retourné par Get-Childitem (index 0).

La deuxième commande ajoute la propriété de note.

La troisième commande utilise un opérateur de pipeline (|) pour envoyer l'objet mis à jour à l'applet de commande Get-Member. La sortie montre que la propriété a été ajoutée.

C:\PS>$a = (get-childitem)[0]

C:\PS> $a | add-member -membertype aliasproperty -name FileLength -value Length 

C:\PS> $a.filelength

Description
-----------
Ces commandes ajoutent la propriété d'alias FileLength à un objet DirectoryInfo retourné par Get-ChildItem. La nouvelle propriété est un alias de la propriété Length. 

La première commande obtient le premier objet retourné par Get-Childitem (index 0).

La deuxième commande ajoute la propriété d'alias.

La troisième ligne de la commande retourne la valeur de la nouvelle propriété FileLength.

C:\PS>$a = "a string"

C:\PS> $a = $a | add-member -membertype noteproperty -name StringUse -value Display -passthru

C:\PS> $a.StringUse

Description
-----------
Ces commandes ajoutent la propriété StringUse à une chaîne. Étant donné que la chaîne n'est pas un objet PSObject, vous devez inclure le paramètre PassThru dans la commande pour enregistrer la chaîne étendue dans la variable. La dernière commande de l'exemple affiche la nouvelle propriété.

C:\PS>$a = "this is a string"

C:\PS> $a = add-member -inputobject $a -membertype scriptmethod -name words `
-value {$this.split()} -passthru

C:\PS> $a.words()

Description
-----------
Ces commandes ajoutent une méthode de script à un objet chaîne. La méthode de script expose la méthode Split() de la classe de bibliothèque de classes .NET Framework System.String pour permettre le retour de mots individuels dans une chaîne via l'appel d'une méthode nommée « Words » sur l'objet chaîne. Notez que le paramètre PassThru est spécifié pour forcer Add-Member à retourner l'objet chaîne étendue en tant que sortie à stocker dans la variable $a.

C:\PS>$event = get-eventlog -logname system -newest 1

C:\PS> $event.TimeWritten | get-member

C:\PS> add-member -inputobject $event -membertype aliasproperty -name When `
-value TimeWritten -secondvalue System.String

C:\PS> $event.When | get-member

Description
-----------
Ces commandes ajoutent un AliasProperty à un objet EventLogEntry retourné par les applets de commande Get-EventLog. L'AliasProperty est nommé « When » et est un alias de la propriété TimeWritten de l'objet. Le paramètre SecondValue est utilisé pour spécifier que la valeur de propriété doit être convertie en type System.String en cas d'accès via AliasProperty ; la propriété TimeWritten est un objet DateTime.

La première commande utilise l'applet de commande Get-EventLog pour récupérer l'événement le plus récent du journal des événements système et l'enregistrer dans la variable $event. 

La deuxième commande accède à la propriété TimeWritten de cet événement et la dirige vers l'applet de commande Get-Member pour montrer que la propriété est de type DateTime. Ensuite, Add-Member est utilisé pour ajouter un membre AliasProperty à l'instance de l'objet EventLogEntry stocké dans la variable $event. Le paramètre Name est utilisé pour donner au nom du nouveau membre la valeur « When » et le paramètre Value est utilisé pour spécifier qu'il s'agit d'un alias de la propriété TimeWritten. Le paramètre SecondValue sert à indiquer que, lorsque ce nouveau membre est utilisé, la valeur qu'il retourne doit être transtypée de son type d'origine System.DateTime en un type System.String. 

La troisième commande accède au nouveau membre et le dirige vers l'applet de commande Get-Member pour confirmer que son type est System.String.

C:\PS>function Copy-Property ($From, $To)

{
  foreach ($p in Get-Member -InputObject $From -MemberType Property)
  {
     Add-Member -InputObject $To -MemberType NoteProperty -Name $p.Name 
     -Value $From.$($p.Name) -Force

     $To.$($p.Name) = $From.$($p.Name)
   }
}

Description
-----------
Cette fonction copie toutes les propriétés d'un objet vers un autre objet.

La première commande de la fonction déclare le nom de cette dernière et liste ses paramètres. 

La boucle Foreach utilise l'applet de commande Get-Member pour obtenir chacune des propriétés de l'objet From. Les commandes de la boucle Foreach sont exécutées en série sur chacune des propriétés.

La commande Add-Member ajoute la propriété de l'objet From à l'objet To en tant que propriété NoteProperty. Elle utilise le paramètre Force pour permettre à la commande d'ajouter des membres portant le même nom.

La dernière commande de la fonction donne à la nouvelle propriété le nom de la propriété d'origine.