Add-Member
Aggiunge un membro personalizzato definito dall'utente a un'istanza di un oggetto di Windows PowerShell.
Descrizione
Aggiunge un membro personalizzato definito dall'utente a un'istanza di un oggetto di Windows PowerShell. Consente di aggiungere i tipi di membri seguenti: AliasProperty, CodeProperty, NoteProperty, ScriptProperty, PropertySet, CodeMethod,MemberSet e ScriptMethod. Per impostare il valore iniziale del membro, viene utilizzato il parametro Value. Nel caso di AliasProperty, ScriptProperty, CodeProperty e CodeMethod, è possibile specificare ulteriori informazioni utilizzando il parametro SecondValue.
I membri vengono aggiunti all'istanza specifica dell'oggetto reindirizzato a add-member o specificato tramite il parametro InputObject. Il membro aggiuntivo è disponibile solo finché l'istanza è disponibile. È possibile utilizzare il cmdlet Export-Clixml per salvare in un file l'istanza e i membri aggiuntivi. Le informazioni archiviate in tale file possono essere utilizzate dal cmdlet Import-Clixml per creare nuovamente l'istanza dell'oggetto.
Parametri
| Nome |
Descrizione e modalità d'uso |
| -inputObject |
-inputObject <psobject>
|
Specifica l'oggetto a cui verrà aggiunto il nuovo membro. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.
|
| -memberType |
-memberType <PSMemberTypes>
|
Specifica il tipo del membro da aggiungere. I valori validi per questo parametro sono: AliasProperty, CodeProperty, NoteProperty, ScriptProperty, PropertySet, CodeMethod, MemberSet e ScriptMethod.
Di seguito sono elencati i valori consentiti per questo parametro:
- AliasProperty
- CodeProperty
- Property
- NoteProperty
- ScriptProperty
- Properties
- PropertySet
- Method
- CodeMethod
- ScriptMethod
- Methods
- ParameterizedProperty
- MemberSet
- All
|
| -name |
-name <string>
|
Specifica il nome del membro da aggiungere.
Se si omette il nome del parametro "-Name", il valore del parametro -Name deve essere il secondo valore di parametro senza nome nel comando. Se si include il nome del parametro, i parametri possono essere riportati in qualsiasi ordine.
|
| -value |
-value <Object>
|
Specifica il valore iniziale del membro aggiunto. Se si aggiunge un membro AliasProperty, CodeProperty o CodeMethod, è possibile specificare ulteriori informazioni facoltative utilizzando il parametro SecondValue.
|
| -secondValue |
-secondValue <Object>
|
Specifica ulteriori informazioni facoltative sui membri AliasProperty, ScriptProperty, CodeProperty o CodeMethod. Se viene utilizzato quando si aggiunge un membro AliasProperty, questo parametro deve essere un tipo di dati. Al valore di AliasProperty verrà aggiunta una conversione (cast) nel tipo di dati specificato. Se ad esempio si aggiunge un membro AliasProperty che fornisce un nome alternativo per una proprietà di stringa, è inoltre possibile specificare un parametro SecondValue di System.Int32 per indicare che il valore di tale proprietà di stringa deve essere convertito in un valore integer quando per l'accesso viene utilizzato il membro AliasProperty corrispondente.
È possibile utilizzare il parametro SecondValue per specificare un membro ScriptBlock aggiuntivo quando si aggiunge un membro ScriptProperty. In tal caso, il primo membro ScriptBlock, specificato nel parametro Value, verrà utilizzato per ottenere il valore di una variabile, mentre il secondo membro ScriptBlock, specificato nel parametro SecondValue, verrà utilizzato per impostare il valore di una variabile.
|
| -force |
-force
|
Aggiunge un nuovo membro anche se ne esiste già uno con lo stesso nome. Non funziona con i membri principali di un tipo.
|
| -passThru |
-passThru
|
Passa l'oggetto appena esteso creato da questo cmdlet attraverso la pipeline. Per impostazione predefinita, questo cmdlet non passa alcun oggetto attraverso la pipeline.
|
Contenuti riprodotti su gentile concessione di Microsoft Corporation.
© 2007 Microsoft Corporation. All rights reserved.