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

Descrizione
-----------
Questi comandi aggiungono la proprietà di nota Status a un oggetto DirectoryInfo restituito da Get-ChildItem e assegnano a essa un valore "done". 

Il primo comando ottiene il primo oggetto restituito da Get-Childitem (indice 0).

Il secondo comando aggiunge la proprietà di nota.

Il terzo comando utilizza un operatore pipeline (|) per inviare l'oggetto aggiornato al cmdlet Get-Member. L'output mostra che la proprietà è stata aggiunta.

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

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

C:\PS> $a.filelength

Descrizione
-----------
Con questi comandi viene aggiunta la proprietà alias FileLength a un oggetto DirectoryInfo restituito da Get-ChildItem. La nuova proprietà è un alias della proprietà Length. 

Il primo comando ottiene il primo oggetto restituito da Get-Childitem (indice 0).

Il secondo comando aggiunge la proprietà alias.

Il terzo comando restituisce il valore della nuova proprietà FileLength.

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

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

C:\PS> $a.StringUse

Descrizione
-----------
Questi comandi aggiungono la proprietà StringUse a una stringa. Poiché la stringa non è un oggetto PSObject, è necessario includere il parametro PassThru nel comando per salvare la stringa estesa nella variabile. Con l'ultimo comando nell'esempio viene visualizzata la nuova proprietà.

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()

Descrizione
-----------
Con questi comandi viene aggiunto un metodo script a un oggetto stringa. Il metodo script esporrà il metodo Split() della classe System.String della libreria di classi .NET Framework per agevolare la restituzione delle singole parole in una stringa mediante la chiamata a un metodo denominato "Words" nell'oggetto stringa. Si noti che per forzare Add-Member a restituire l'oggetto stringa esteso come output da archiviare nella variabile $a, viene utilizzato il parametro PassThru.

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

Descrizione
-----------
Tramite questi comandi una proprietà AliasProperty viene aggiunta a un oggetto EventLogEntry restituito dai cmdlet Get-EventLog. Il nome della proprietà AliasProperty è "When" e rappresenta un alias della proprietà TimeWritten dell'oggetto. Verrà quindi utilizzato il parametro SecondValue per specificare che il valore della proprietà deve essere convertito nel tipo System.String quando l'accesso viene effettuato tramite AliasProperty. La proprietà TimeWritten è un oggetto DateTime.

Nel primo comando viene utilizzato il cmdlet Get-EventLog per recuperare dal registro eventi di sistema l'evento più recente che viene quindi archiviato nella variabile $event. 

Il secondo comando accede alla proprietà TimeWritten di tale evento e la reindirizza al cmdlet Get-Member per dimostrare che la proprietà è un tipo DateTime. Add-Member viene quindi utilizzato per aggiungere un membro AliasProperty all'istanza dell'oggetto EventLogEntry archiviato nella variabile $event. Vengono quindi utilizzati il parametro Name per impostare il nome del nuovo membro su "When" e il parametro Value per specificare che si tratta di un alias della proprietà 'TimeWritten'. Viene infine utilizzato il parametro SecondValue per indicare che, quando verrà utilizzato il nuovo membro, sarà necessario eseguire il cast del valore restituito dal relativo tipo System.DateTime originale in un tipo System.String. 

Nel terzo del comando viene effettuato l'accesso al nuovo membro che viene reindirizzato al cmdlet Get-Member per confermare che il tipo del membro è 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)
   }
}

Descrizione
-----------
Questa funzione copia tutte le proprietà di un oggetto in un altro oggetto.

Nel primo comando della funzione viene dichiarato il nome della funzione e ne vengono elencati i parametri. 

Nel ciclo Foreach viene utilizzato il cmdlet Get-Member per ottenere ogni proprietà dell'oggetto From. I comandi nel ciclo Foreach vengono eseguiti in serie per ogni proprietà.

Con il comando Add-Member la proprietà dell'oggetto From viene aggiunta all'oggetto To come NoteProperty. Viene utilizzato il parametro Force per consentire al comando di aggiungere membri con lo stesso nome di membro.

L'ultimo comando della funzione fornisce alla nuova proprietà lo stesso nome della proprietà originale.