ETS-eigenschappen

Eigenschappen zijn leden die kunnen worden behandeld als een eigenschap. In wezen kunnen ze aan de linkerkant van een expressie worden weergegeven. De beschikbare eigenschappen zijn alias-, code-, notitie- en scripteigenschappen.

Alias-eigenschap

Een alias-eigenschap is een eigenschap die verwijst naar een andere eigenschap die het PSObject-object bevat. Deze wordt voornamelijk gebruikt om de naam van de eigenschap waarnaar wordt verwezen, te wijzigen. Het kan echter ook worden gebruikt om de waarde van de eigenschap waarnaar wordt verwezen te converteren naar een ander type. Met betrekking tot ETS is dit type eigenschap altijd een uitgebreid lid en wordt deze gedefinieerd door de klasse PSAliasProperty. De klasse bevat de volgende eigenschappen.

  • Eigenschap ConversionType: het CLR-type dat wordt gebruikt voor het converteren van de waarde van het lid waarnaar wordt verwezen.
  • Eigenschap IsGettable: geeft aan of de waarde van de eigenschap waarnaar wordt verwezen kan worden opgehaald. Deze eigenschap wordt dynamisch bepaald door de eigenschap IsGettable van de eigenschap waarnaar wordt verwezen te onderzoeken.
  • Eigenschap IsSettable: geeft aan of de waarde van de eigenschap waarnaar wordt verwezen kan worden ingesteld. Deze eigenschap wordt dynamisch bepaald door de eigenschap IsSettable van de eigenschap waarnaar wordt verwezen te onderzoeken.
  • Eigenschap MemberType: Een aliasProperty-opseratieconstante die deze eigenschap definieert als een aliaseigenheid.
  • De eigenschap ReferencedMemberName: de naam van de eigenschap waarnaar wordt verwezen waarnaar deze alias verwijst.
  • Eigenschap TypeNameOfValue: de volledige naam van het CLR-type van de waarde van de eigenschap waarnaar wordt verwezen.
  • Eigenschap Value: de waarde van de eigenschap waarnaar wordt verwezen.

Code-eigenschap

Een code-eigenschap is een eigenschap die een getter en setter is die is gedefinieerd in een CLR-taal. Om een code-eigenschap beschikbaar te maken, moet een ontwikkelaar de eigenschap in een clr-taal schrijven, compileren en verzenden van de resultaatassemblage. Deze assembly moet beschikbaar zijn in de runspace waar de code-eigenschap gewenst is. Met betrekking tot ETS is dit type eigenschap altijd een uitgebreid lid en wordt deze gedefinieerd door de psCodeProperty-klasse. De klasse bevat de volgende eigenschappen.

  • Eigenschap GetterCodeReference: de methode die wordt gebruikt om de waarde van de code-eigenschap op te halen.
  • Eigenschap IsGettable: geeft aan of de waarde van de code-eigenschap kan worden opgehaald, dat de eigenschap SetterCodeReference: de methode die wordt gebruikt om de waarde van de code-eigenschap in te stellen.
  • Eigenschap IsSettable: geeft aan of de waarde van de code-eigenschap kan worden ingesteld, of de eigenschap SetterCodeReference niet null is.
  • Eigenschap MemberType: een codeProperty-opseratieconstante die deze eigenschap definieert als een code-eigenschap.
  • Eigenschap SetterCodeReference: de methode die wordt gebruikt om de waarde van de code-eigenschap op te halen.
  • Eigenschap TypeNameOfValue: het CLR-type van de waarde van de code-eigenschap die wordt geretourneerd door de eigenschappen get-bewerking.
  • Eigenschap Value: de waarde van de code-eigenschap. Wanneer deze eigenschap wordt opgehaald, wordt de getter-code in de eigenschap GetterCodeReference aangeroepen, en wordt het huidige PSObject-object doorgegeven en de waarde geretourneerd die door de aanroep wordt geretourneerd. Wanneer deze eigenschap is ingesteld, wordt de settercode in de eigenschap SetterCodeReference aangeroepen, waarmee het huidige PSObject-object als het eerste argument en het object wordt gebruikt om de waarde in te stellen als het tweede argument.

Opmerkings eigenschap

Een eigenschap Note is een eigenschap die een naam/waarde-koppeling heeft. Met betrekking tot ETS is dit type eigenschap altijd een uitgebreid lid en wordt deze gedefinieerd door de PSNoteProperty-klasse. De klasse bevat de volgende eigenschappen.

  • Eigenschap IsGettable: geeft aan of de waarde van de notitie-eigenschap kan worden opgehaald.
  • Eigenschap IsSettable: geeft aan of de waarde van de notitie-eigenschap kan worden ingesteld.
  • Eigenschap MemberType: een NoteProperty-opseratieconstante die deze eigenschap definieert als een notitie-eigenschap.
  • Eigenschap TypeNameOfValue: de volledig gekwalificeerde typenaam van het object dat wordt geretourneerd door de get-bewerking van de notitie-eigenschap.
  • Waarde: de waarde van de notitie-eigenschap.

PowerShell-eigenschap

Een PowerShell-eigenschap is een eigenschap die is gedefinieerd op het basisobject of een eigenschap die beschikbaar wordt gesteld via een adapter. Het kan verwijzen naar zowel CLR-velden als CLR-eigenschappen. Met betrekking tot ETS kan dit type eigenschap een basislid of een adapterlid zijn en wordt gedefinieerd door de PSProperty-klasse. De klasse bevat de volgende eigenschappen.

  • Eigenschap IsGettable: geeft aan of de waarde van de basis- of aangepaste eigenschap kan worden opgehaald.
  • Eigenschap IsSettable: geeft aan of de waarde van de basis- of aangepaste eigenschap kan worden ingesteld.
  • Eigenschap MemberType: een eigenschapsinstantie die deze eigenschap definieert als een PowerShell-eigenschap.
  • Eigenschap TypeNameOfValue: de volledig gekwalificeerde naam van het type eigenschapswaarde. Voor een eigenschap waarvan de waarde bijvoorbeeld een tekenreeks is, is het waardetype van de eigenschap System.String.
  • Eigenschap Value: de waarde van de eigenschap . Als de get- of set-bewerking wordt aangeroepen voor een eigenschap die deze bewerking niet ondersteunt, wordt er een Uitzondering GetValueException of SetValueException gemaakt

PowerShell Script-eigenschap

De eigenschap Script is een eigenschap met getter- en setterscripts. Met betrekking tot ETS is dit type eigenschap altijd een uitgebreid lid en wordt deze gedefinieerd door de PSScriptProperty-klasse. De klasse bevat de volgende eigenschappen.

  • GetterScript-eigenschap: het script dat wordt gebruikt om de waarde van de script-eigenschap op te halen.
  • Eigenschap IsGettable: geeft aan of de eigenschap GetterScript een scriptblok toont.
  • Eigenschap IsSettable: geeft aan of de eigenschap SetterScript een scriptblok toont.
  • Eigenschap MemberType: een ScriptProperty-opseeratieconstante die deze eigenschap identificeert als een scripteigenheid.
  • Eigenschap SetterScript: het script dat wordt gebruikt om de waarde van de script-eigenschap in te stellen.
  • Eigenschap TypeNameOfValue: de volledig gekwalificeerde typenaam van het object dat wordt geretourneerd door het getter-script. In dit geval wordt System.Object altijd geretourneerd.
  • Eigenschap Value: de waarde van de script-eigenschap. Een get roept het getter-script aan en retourneert de opgegeven waarde. Een set roept het setterscript aan.