Get-ShopifyCustomer

ÜBERSICHT

Sucht einen Shopify-Kunden anhand der E-Mail-Adresse.

SYNTAX

Get-ShopifyCustomer [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-Email] <string>
    [[-MaxRetries] <int>] [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG

Durchsucht die Shopify-Kunden über die GraphQL Admin API nach einem Kunden mit der angegebenen E-Mail-Adresse. Gibt den ersten gefundenen Kunden als PSCustomObject zurück oder $null, wenn kein Kunde mit dieser E-Mail existiert.

Die Funktion wird typischerweise verwendet, um vor einem Upload zu prüfen, ob ein Kunde bereits existiert (Upsert-Logik).

Das Ergebnis wird in ein REST-kompatibles Format normalisiert: GIDs werden in numerische IDs umgewandelt, edges in flache Arrays.

PARAMETER

-Shop

Type: string

Shopify-Shop-Domain, z.B. 'mein-shop.myshopify.com'.

-Token

Type: string

Admin API Access Token (shpat_...) der Custom App.

-ApiVersion

Type: string

API-Version, z.B. '2026-01'.

-Email

Type: string

Die E-Mail-Adresse, nach der gesucht wird.

-MaxRetries

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN

pscustomobject

BEISPIELE

# Kunde per E-Mail suchen
$customer = Get-ShopifyCustomer -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2026-01' -Email 'kunde@example.com'

# prüfen ob Kunde existiert
$existing = Get-ShopifyCustomer -Shop $shop -Token $token `
  -ApiVersion '2026-01' -Email 'info@firma.de'
if ($null -eq $existing) {
  Write-Host "Kunde nicht vorhanden, wird neu angelegt."
}