base64

Zusammenfassung

Gibt die Base64-Darstellung einer Eingabezeichenfolge zurück.

Syntax

base64(<inputString>)

BESCHREIBUNG

Die base64() Funktion gibt die Base64-Darstellung einer Eingabezeichenfolge zurück. Das Übergeben von Daten, die als Base64 codiert sind, kann Fehler beim Übergeben von Daten reduzieren, insbesondere wenn verschiedene Tools unterschiedliche Escapezeichen erfordern.

Beispiele

Beispiel 1: Konvertieren einer Zeichenfolge in base64

Die Konfiguration konvertiert einen grundlegenden Zeichenfolgenwert mit der base64() -Funktion.

# base64.example.1.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Echo 'abc' in base64
    type: Microsoft.DSC.Debug/Echo
    properties:
      output: "[base64('abc')]"

dsc --file base64.example.1.dsc.config.yaml config get

results:
- name: Echo 'abc' in base64
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: YWJj
messages: []
hadErrors: false

Beispiel 2: Konvertieren einer verketteten Zeichenfolge in base64

Die Konfiguration verwendet die concat() -Funktion innerhalb der base64() Funktion, um die Zeichenfolgen a, bund c in abc zu kombinieren, bevor die base64-Darstellung zurückgegeben wird.

# base64.example.2.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Echo concatenated 'a', 'b', 'c' in base64
    type: Microsoft.DSC.Debug/Echo
    properties:
      output: "[base64(concat('a', 'b', 'c'))]"

dsc --file base64.example.2.dsc.config.yaml config get

results:
- name: Echo concatenated 'a', 'b', 'c' in base64
  type: Microsoft.DSC.Debug/Echo
  result:
    actualState:
      output: YWJj
messages: []
hadErrors: false

Parameter

inputString

Die base64() Funktion erwartet eine einzelne Zeichenfolge als Eingabe. Die -Funktion konvertiert den Wert in eine Base64-Darstellung. Wenn der Wert keine Zeichenfolge ist, löst DSC beim Überprüfen des Konfigurationsdokuments einen Fehler aus.

Type:         string
Required:     true
MinimumCount: 1
MaximumCount: 1

Ausgabe

Die base64() Funktion gibt die base64-Darstellung des inputString-Werts zurück.

Type: string