Get-MemberValue

Ü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