Get-MemberValue #

Intern – Diese Funktion ist nicht exportiert und nur modulintern verfügbar.

ÜBERSICHT #

Liest eine Eigenschaft oder einen Dictionary-Key sicher aus, ohne Fehler bei fehlenden Membern.

SYNTAX #

Get-MemberValue [[-Object] <object>] [-Name] <string> [<CommonParameters>]

BESCHREIBUNG #

Gibt den Wert eines Members zurück, wenn er vorhanden ist, andernfalls $null.

Unterstützte Eingabetypen:

• PSCustomObject / beliebige Objekte: Zugriff über PSObject.Properties[$Name]
• IDictionary (z.B. Hashtable): Zugriff über .Contains($Name) und Indexer [$Name]

Zweck:

• Nützlich bei optionalen Properties (z.B. aus JSON), besonders wenn StrictMode aktiv ist.
• Verhindert, dass fehlende Properties (z.B. “Cc”) sofort eine Exception auslösen.

PARAMETER #

-Object #

Type: object

Objekt oder Dictionary, aus dem gelesen werden soll. Bei $null wird $null zurückgegeben.

-Name #

Type: string

Name der Eigenschaft bzw. des Dictionary-Keys.

AUSGABEN #

System.Object

Gibt den gefundenen Wert zurück oder $null, wenn nicht vorhanden.

BEISPIELE #

# Optionales Property StrictMode-sicher lesen
$cc = Get-MemberValue -Object $mailConfig -Name 'Cc'

# Hashtable / Dictionary sicher lesen
$val = Get-MemberValue -Object @{ Port = 587 } -Name 'Port'

# Fehlender Member liefert $null statt Fehler
Get-MemberValue -Object ([pscustomobject]@{ To = 'a@b.de' }) -Name 'Bcc'

HINWEISE #

Wird unter anderem in Send-JsonDbMail verwendet