Set-ShopifyProductImage #

ÜBERSICHT #

Lädt ein Bild zu einem Shopify-Produkt hoch.

SYNTAX #

Set-ShopifyProductImage [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-ProductId]
    <long> [-ImagePath] <string> [[-Position] <int>] [[-AltText] <string>] [[-MaxRetries] <int>]
    [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG #

Führt einen dreistufigen Upload-Prozess per GraphQL durch:

1. stagedUploadsCreate – Upload-URL und Parameter anfordern
2. HTTP POST Multipart – Bild an die staged URL hochladen
3. productCreateMedia – Bild am Produkt registrieren

Die Position bestimmt die Reihenfolge in der Galerie.

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. ‘2025-01’.

-ProductId #

Type: long

Shopify-Produkt-ID, zu der das Bild hinzugefügt wird.

-ImagePath #

Type: string

Lokaler Pfad zur Bilddatei (JPG, PNG, GIF, WebP).

-Position #

Type: int
Default: 1

Position des Bildes in der Galerie (1 = Hauptbild).

-AltText #

Type: string

Optionaler Alternativtext für das Bild.

-MaxRetries #

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec #

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN #

pscustomobject

BEISPIELE #

# Hauptbild hochladen
Set-ShopifyProductImage -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' `
  -ProductId 123456789 -ImagePath 'C:\DMS\1100-1.jpg' -Position 1

# Zweites Bild mit Alt-Text
Set-ShopifyProductImage -Shop $shop -Token $token -ApiVersion '2025-01' `
  -ProductId $id -ImagePath 'C:\DMS\1100-2.jpg' -Position 2 -AltText 'Seitenansicht'