Set-ShopifyMetafieldDefinition #

ÜBERSICHT #

Legt eine Metafield-Definition in Shopify an (idempotent).

SYNTAX #

Set-ShopifyMetafieldDefinition [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [-Name]
    <string> [-Namespace] <string> [-Key] <string> [-Type] <string> [-OwnerType] <string>
    [[-Description] <string>] [[-CustomerAccountAccess] <bool>] [[-MaxRetries] <int>]
    [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG #

Erstellt eine Metafield-Definition über die GraphQL Admin API. Wenn die Definition bereits existiert (Code TAKEN), wird kein Fehler geworfen, sondern ein Ergebnis mit AlreadyExists = $true zurückgegeben.

Optional kann der Zugriff für Kundenkonten aktiviert werden (CustomerAccountAccess), damit Metafield-Werte auf der Bestellstatus-Seite sichtbar sind.

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’.

-Name #

Type: string

Anzeigename der Metafield-Definition.

-Namespace #

Type: string

Namespace des Metafields, z.B. ‘custom’.

-Key #

Type: string

Schlüssel des Metafields, z.B. ‘invoice_pdf’.

-Type #

Type: string

Datentyp, z.B. ‘file_reference’, ‘single_line_text_field’.

-OwnerType #

Type: string

Ressourcentyp: ORDER, PRODUCT, CUSTOMER oder COLLECTION.

-Description #

Type: string
Default: ''

Optionale Beschreibung der Definition.

-CustomerAccountAccess #

Type: bool
Default: $false

Wenn $true, wird der Lesezugriff für Kundenkonten aktiviert.

-MaxRetries #

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec #

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN #

pscustomobject -- Objekt mit Id, Name, Namespace, Key, AlreadyExists.

BEISPIELE #

Set-ShopifyMetafieldDefinition -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2025-01' `
  -Name 'Rechnung PDF' -Namespace 'custom' -Key 'invoice_pdf' `
  -Type 'file_reference' -OwnerType 'ORDER' -CustomerAccountAccess $true