Microsoft.Resources deploymentScripts

Artikel
10/19/2024

Bicep-Ressourcendefinition

Der DeploymentScripts-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Bemerkungen

Informationen zum Ausführen von Skripts während der Bereitstellung finden Sie unter Verwenden von Bereitstellungsskripts in Bicep oder Verwenden von Bereitstellungsskripts in ARM-Vorlagen.

Ressourcenformat

Um eine Microsoft.Resources/deploymentScripts-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Resources/deploymentScripts@2023-08-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  // For remaining properties, see deploymentScripts objects
}

deploymentScripts-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AzureCLI:

  kind: 'AzureCLI'
  properties: {
    arguments: 'string'
    azCliVersion: 'string'
    cleanupPreference: 'string'
    containerSettings: {
      containerGroupName: 'string'
      subnetIds: [
        {
          id: 'string'
          name: 'string'
        }
      ]
    }
    environmentVariables: [
      {
        name: 'string'
        secureValue: 'string'
        value: 'string'
      }
    ]
    forceUpdateTag: 'string'
    primaryScriptUri: 'string'
    retentionInterval: 'string'
    scriptContent: 'string'
    storageAccountSettings: {
      storageAccountKey: 'string'
      storageAccountName: 'string'
    }
    supportingScriptUris: [
      'string'
    ]
    timeout: 'string'
  }

Verwenden Sie für AzurePowerShell-:

  kind: 'AzurePowerShell'
  properties: {
    arguments: 'string'
    azPowerShellVersion: 'string'
    cleanupPreference: 'string'
    containerSettings: {
      containerGroupName: 'string'
      subnetIds: [
        {
          id: 'string'
          name: 'string'
        }
      ]
    }
    environmentVariables: [
      {
        name: 'string'
        secureValue: 'string'
        value: 'string'
      }
    ]
    forceUpdateTag: 'string'
    primaryScriptUri: 'string'
    retentionInterval: 'string'
    scriptContent: 'string'
    storageAccountSettings: {
      storageAccountKey: 'string'
      storageAccountName: 'string'
    }
    supportingScriptUris: [
      'string'
    ]
    timeout: 'string'
  }

Eigenschaftswerte

deploymentScripts

Name	Beschreibung	Wert
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Ort	Der Speicherort der ACI und des Speicherkontos für das Bereitstellungsskript.	Zeichenfolge (erforderlich)
Schilder	Ressourcentags.	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art	Festlegen des Objekttyps	AzureCLI AzurePowerShell- (erforderlich)
Identität	Optionale Eigenschaft. Verwaltete Identität, die für dieses Bereitstellungsskript verwendet werden soll. Derzeit wird nur vom Benutzer zugewiesene MSI unterstützt.	ManagedServiceIdentity-

AzureCliScript

Name	Beschreibung	Wert
Art	Typ des Skripts.	"AzureCLI" (erforderlich)
Eigenschaften	Eigenschaften des Azure CLI-Skriptobjekts.	AzureCliScriptProperties- (erforderlich)

AzureCliScriptProperties

Name	Beschreibung	Wert
Argumente	Befehlszeilenargumente, die an das Skript übergeben werden sollen. Argumente werden durch Leerzeichen getrennt. z. B. -Name blau* -Location "West US 2"	Schnur
azCliVersion	Zu verwendende Azure CLI-Modulversion.	Zeichenfolge (erforderlich)
cleanupPreference	Die Bereinigungseinstellung, wenn die Skriptausführung in einem Terminalzustand angezeigt wird. Die Standardeinstellung lautet "Immer".	"Immer" "OnExpiration" "OnSuccess"
containerSettings	Containereinstellungen.	ContainerConfiguration-
environmentVariables	Die Umgebungsvariablen, die an das Skript übergeben werden sollen.	EnvironmentVariable[]
forceUpdateTag	Ruft ab oder legt fest, wie das Bereitstellungsskript ausgeführt werden soll, auch wenn die Skriptressource nicht geändert wurde. Dies kann ein aktueller Zeitstempel oder eine GUID sein.	Schnur
primaryScriptUri	URI für das Skript. Dies ist der Einstiegspunkt für das externe Skript.	Schnur
retentionInterval	Intervall, für das der Dienst die Skriptressource behält, nachdem er einen Terminalstatus erreicht hat. Die Ressource wird gelöscht, wenn diese Dauer abläuft. Die Dauer basiert auf dem ISO 8601-Muster (z. B. P1D bedeutet einen Tag).	Zeichenfolge (erforderlich)
scriptContent	Skripttext.	Schnur
storageAccountSettings	Speicherkontoeinstellungen.	StorageAccountConfiguration-
supportScriptUris	Unterstützende Dateien für das externe Skript.	string[]
Zeitüberschreitung	Maximal zulässige Skriptausführungszeit im ISO 8601-Format. Standardwert ist P1D	Schnur

ContainerConfiguration

Name	Beschreibung	Wert
containerGroupName	Containergruppenname, wenn nicht angegeben, wird der Name automatisch generiert. Kein Angeben eines "containerGroupName" gibt an, dass das System einen eindeutigen Namen generiert, der dazu führen kann, dass eine Azure-Richtlinie als nicht konform gekennzeichnet wird. Verwenden Sie "containerGroupName", wenn Sie über eine Azure-Richtlinie verfügen, die eine bestimmte Benennungskonvention erwartet oder wenn Sie den Namen vollständig steuern möchten. Die Eigenschaft "containerGroupName" muss zwischen 1 und 63 Zeichen lang sein, darf nur Kleinbuchstaben, Zahlen und Gedankenstriche enthalten, und sie darf nicht mit einem Gedankenstrich beginnen oder enden, und aufeinander folgende Striche sind nicht zulässig. Um einen 'containerGroupName' anzugeben, fügen Sie das folgende Objekt zu Eigenschaften hinzu: { "containerSettings": { "containerGroupName": "contoso-container" } }. Wenn Sie keinen 'containerGroupName' angeben möchten, fügen Sie keine 'containerSettings'-Eigenschaft hinzu.	Schnur Zwänge: Min. Länge = 1 Max. Länge = 63
Subnetz-ID	Die Subnetzressourcen-IDs für eine Containergruppe.	ContainerGroupSubnetId[]

ContainerGroupSubnetId

Name	Beschreibung	Wert
id	Ressourcen-ID des Subnetzes.	Zeichenfolge (erforderlich)
Name	Anzeigename für das Subnetz.	Schnur

EnvironmentVariable

Name	Beschreibung	Wert
Name	Der Name der Umgebungsvariable.	Zeichenfolge (erforderlich)
secureValue	Der Wert der Variablen für die sichere Umgebung.	Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter.
Wert	Der Wert der Umgebungsvariable.	Schnur

StorageAccountConfiguration

Name	Beschreibung	Wert
storageAccountKey	Der Zugriffsschlüssel für das Speicherkonto.	Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter.
storageAccountName	Der Name des Speicherkontos.	Schnur

AzurePowerShellScript

Name	Beschreibung	Wert
Art	Typ des Skripts.	"AzurePowerShell" (erforderlich)
Eigenschaften	Eigenschaften des Azure PowerShell-Skriptobjekts.	AzurePowerShellScriptProperties- (erforderlich)

AzurePowerShellScriptProperties

Name	Beschreibung	Wert
Argumente	Befehlszeilenargumente, die an das Skript übergeben werden sollen. Argumente werden durch Leerzeichen getrennt. z. B. -Name blau* -Location "West US 2"	Schnur
azPowerShellVersion	Zu verwendende Azure PowerShell-Modulversion.	Zeichenfolge (erforderlich)
cleanupPreference	Die Bereinigungseinstellung, wenn die Skriptausführung in einem Terminalzustand angezeigt wird. Die Standardeinstellung lautet "Immer".	"Immer" "OnExpiration" "OnSuccess"
containerSettings	Containereinstellungen.	ContainerConfiguration-
environmentVariables	Die Umgebungsvariablen, die an das Skript übergeben werden sollen.	EnvironmentVariable[]
forceUpdateTag	Ruft ab oder legt fest, wie das Bereitstellungsskript ausgeführt werden soll, auch wenn die Skriptressource nicht geändert wurde. Dies kann ein aktueller Zeitstempel oder eine GUID sein.	Schnur
primaryScriptUri	URI für das Skript. Dies ist der Einstiegspunkt für das externe Skript.	Schnur
retentionInterval	Intervall, für das der Dienst die Skriptressource behält, nachdem er einen Terminalstatus erreicht hat. Die Ressource wird gelöscht, wenn diese Dauer abläuft. Die Dauer basiert auf dem ISO 8601-Muster (z. B. P1D bedeutet einen Tag).	Zeichenfolge (erforderlich)
scriptContent	Skripttext.	Schnur
storageAccountSettings	Speicherkontoeinstellungen.	StorageAccountConfiguration-
supportScriptUris	Unterstützende Dateien für das externe Skript.	string[]
Zeitüberschreitung	Maximal zulässige Skriptausführungszeit im ISO 8601-Format. Standardwert ist P1D	Schnur

ManagedServiceIdentity

Name	Beschreibung	Wert
Art	Typ der verwalteten Identität.	"UserAssigned"
userAssignedIdentities	Die Liste der vom Benutzer zugewiesenen verwalteten Identitäten, die der Ressource zugeordnet sind. Der Schlüssel ist die Azure-Ressourcen-ID der verwalteten Identität.	ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name	Beschreibung	Wert
{angepasste Eigenschaft}		UserAssignedIdentity-

UserAssignedIdentity

Dieses Objekt enthält keine Eigenschaften, die während der Bereitstellung festgelegt werden sollen. Alle Eigenschaften sind ReadOnly.

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
min.io Azure Gateway-	Vollständig private min.io Azure Gateway-Bereitstellung, um eine S3-kompatible Speicher-API bereitzustellen, die durch BLOB-Speicher gesichert wird
Erstellen einer WordPress-Website	Diese Vorlage erstellt eine WordPress-Website auf containerinstanz
Azure Image Builder mit Azure Windows Baseline	Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit den neuesten Angewendeten Windows-Updates und Azure Windows Baseline.
Importieren von VHD-Blobs aus einer ZIP-Archiv-URL	Für die Bereitstellung virtueller Computer, die auf speziellen Datenträgerimages basieren, müssen VHD-Dateien in ein Speicherkonto importiert werden. Falls mehrere VHD-Dateien in einer einzelnen ZIP-Datei komprimiert sind und Sie die URL zum Abrufen des ZIP-Archivs erhalten haben, erleichtert diese ARM-Vorlage den Auftrag: Herunterladen, Extrahieren und Importieren in einen vorhandenen Blob-Container für Speicherkonten.
Kopieren einer Datei aus einem URI in einen BLOB-Speichercontainer	Dieses Modul lädt eine Datei aus einem URI herunter und kopiert sie in einen Azure storageAccount-BLOB-Container. Das storageAccount muss bereits vorhanden sein, und die Quelldatei muss bereits auf den URI eingestellt werden.
Erstellt eine Container-App und -Umgebung mit Registrierungs-	Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App aus einer Azure-Containerregistrierung. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps	Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Bereitstellen einer einfachen Azure Spring Apps Microservice-Anwendung	Diese Vorlage stellt eine einfache Azure Spring Apps Microservice-Anwendung bereit, die auf Azure ausgeführt werden kann.
Front Door Standard/Premium mit statischem Websiteursprung	Diese Vorlage erstellt eine Statische Azure Storage Standard/Premium-Website und eine statische Azure Storage-Website und konfiguriert Front Door, um Datenverkehr an die statische Website zu senden.
Erstellen eines ON-Demand-SFTP-Servers mit persistentem Speicher	Diese Vorlage veranschaulicht einen ON-Demand-SFTP-Server mit einer Azure Container Instance (ACI).
FinOps Hub-	Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Lake-Speicher und einer Data Factory.
Erstellen eines Blobs für das Datenfactory-Kopier-Datentool – Schnellstart	Diese Vorlage erstellt einen BLOB-Speicher und lädt eine Datei für das Schnellstartprogramm zum Kopieren von Daten hoch.
Mehr ist mit Azure Data Factory möglich – Ein Klick, um Azure Data Factory	Diese Vorlage erstellt eine Datenfactorypipeline für eine Kopieraktivität aus Azure Blob in ein anderes Azure Blob
Konfigurieren des Dev Box-Diensts	Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß Dev Box-Schnellstarthandbuch (https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.
Azure Container Service (AKS) mit Helm	Bereitstellen eines verwalteten Clusters mit Azure Container Service (AKS) mit Helm
Erstellen eines Azure Machine Learning-Aufräumauftrags	Diese Vorlage erstellt einen Azure Machine Learning Sweep-Auftrag für die Hyperparameteroptimierung.
Testumgebung für Azure Firewall Premium	Diese Vorlage erstellt eine Azure Firewall Premium- und Firewallrichtlinie mit Premium-Features wie Intrusion Inspection Detection (IDPS), TLS-Inspektion und Webkategoriefilterung
Erstellen von Containerimages mit ACR-Aufgaben-	Diese Vorlage verwendet DeploymentScript, um ACR zu koordinieren, um Ihr Containerimage aus dem Code-Repository zu erstellen.
Containerimages in ACR- importieren	Diese Vorlage nutzt das Modul "Importieren von ACR" aus der Bicep-Registrierung, um öffentliche Containerimages in eine Azure-Containerregistrierung zu importieren.
Erstellen eines Anwendungsgateways mit Zertifikaten	Diese Vorlage zeigt, wie Sie selbstsignierte Key Vault-Zertifikate generieren und dann vom Anwendungsgateway referenzieren.
Verwenden eines Bereitstellungsskripts zum Erstellen von Azure AD-Objekten	In diesem Beispiel wird ein Bereitstellungsskript zum Erstellen von Objekten in Azure Active Directory verwendet.
Erstellen eines Bereitstellungsskripts mit komplexen Eingaben & Ausgaben	Diese Vorlage veranschaulicht bewährte Methoden zum Übergeben und Lesen komplexer Eingaben, Ausgaben und Protokolle an ein Az CLI-Bereitstellungsskript.
Erstellen eines Bereitstellungsskripts mit komplexen Eingaben & Ausgaben	Diese Vorlage veranschaulicht bewährte Methoden zum Übergeben und Lesen komplexer Eingaben, Ausgaben und Protokolle an ein Az Powershell-Bereitstellungsskript
Erstellen von SSH-Schlüsseln und Speichern in KeyVault	Diese Vorlage verwendet die DeploymentScript-Ressource, um SSH-Schlüssel zu generieren und den privaten Schlüssel in keyVault zu speichern.
Stellt eine statische Website	Stellt eine statische Website mit einem Sicherungsspeicherkonto bereit.
Funktions-App unter Linux-Verbrauchsplan mit RemoteBuild-	Diese Vorlage stellt eine Funktions-App in einem Linux-Verbrauchsplan bereit und führt während der Codebereitstellung Remotebuilds aus. Die App wird bei Bedarf ausgeführt, und Sie werden pro Ausführung abgerechnet, ohne ständige Ressourcenverpflichtung.
Erstellen eines Azure Virtual Network Manager und Beispiel-VNETs-	Diese Vorlage stellt einen Azure Virtual Network Manager bereit und stellt virtuelle Netzwerke in der benannten Ressourcengruppe bereit. Sie unterstützt mehrere Verbindungstopologien und Netzwerkgruppenmitgliedschaftstypen.

ARM-Vorlagenressourcendefinition

Der DeploymentScripts-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Bemerkungen

Informationen zum Ausführen von Skripts während der Bereitstellung finden Sie unter Verwenden von Bereitstellungsskripts in Bicep oder Verwenden von Bereitstellungsskripts in ARM-Vorlagen.

Ressourcenformat

Um eine Microsoft.Resources/deploymentScripts-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Resources/deploymentScripts",
  "apiVersion": "2023-08-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  // For remaining properties, see deploymentScripts objects
}

deploymentScripts-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AzureCLI:

  "kind": "AzureCLI",
  "properties": {
    "arguments": "string",
    "azCliVersion": "string",
    "cleanupPreference": "string",
    "containerSettings": {
      "containerGroupName": "string",
      "subnetIds": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    },
    "environmentVariables": [
      {
        "name": "string",
        "secureValue": "string",
        "value": "string"
      }
    ],
    "forceUpdateTag": "string",
    "primaryScriptUri": "string",
    "retentionInterval": "string",
    "scriptContent": "string",
    "storageAccountSettings": {
      "storageAccountKey": "string",
      "storageAccountName": "string"
    },
    "supportingScriptUris": [ "string" ],
    "timeout": "string"
  }

Verwenden Sie für AzurePowerShell-:

  "kind": "AzurePowerShell",
  "properties": {
    "arguments": "string",
    "azPowerShellVersion": "string",
    "cleanupPreference": "string",
    "containerSettings": {
      "containerGroupName": "string",
      "subnetIds": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    },
    "environmentVariables": [
      {
        "name": "string",
        "secureValue": "string",
        "value": "string"
      }
    ],
    "forceUpdateTag": "string",
    "primaryScriptUri": "string",
    "retentionInterval": "string",
    "scriptContent": "string",
    "storageAccountSettings": {
      "storageAccountKey": "string",
      "storageAccountName": "string"
    },
    "supportingScriptUris": [ "string" ],
    "timeout": "string"
  }

Eigenschaftswerte

deploymentScripts

Name	Beschreibung	Wert
Art	Der Ressourcentyp	"Microsoft.Resources/deploymentScripts"
apiVersion	Die Ressourcen-API-Version	'2023-08-01'
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Ort	Der Speicherort der ACI und des Speicherkontos für das Bereitstellungsskript.	Zeichenfolge (erforderlich)
Schilder	Ressourcentags.	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art	Festlegen des Objekttyps	AzureCLI AzurePowerShell- (erforderlich)
Identität	Optionale Eigenschaft. Verwaltete Identität, die für dieses Bereitstellungsskript verwendet werden soll. Derzeit wird nur vom Benutzer zugewiesene MSI unterstützt.	ManagedServiceIdentity-

AzureCliScript

Name	Beschreibung	Wert
Art	Typ des Skripts.	"AzureCLI" (erforderlich)
Eigenschaften	Eigenschaften des Azure CLI-Skriptobjekts.	AzureCliScriptProperties- (erforderlich)

AzureCliScriptProperties

Name	Beschreibung	Wert
Argumente	Befehlszeilenargumente, die an das Skript übergeben werden sollen. Argumente werden durch Leerzeichen getrennt. z. B. -Name blau* -Location "West US 2"	Schnur
azCliVersion	Zu verwendende Azure CLI-Modulversion.	Zeichenfolge (erforderlich)
cleanupPreference	Die Bereinigungseinstellung, wenn die Skriptausführung in einem Terminalzustand angezeigt wird. Die Standardeinstellung lautet "Immer".	"Immer" "OnExpiration" "OnSuccess"
containerSettings	Containereinstellungen.	ContainerConfiguration-
environmentVariables	Die Umgebungsvariablen, die an das Skript übergeben werden sollen.	EnvironmentVariable[]
forceUpdateTag	Ruft ab oder legt fest, wie das Bereitstellungsskript ausgeführt werden soll, auch wenn die Skriptressource nicht geändert wurde. Dies kann ein aktueller Zeitstempel oder eine GUID sein.	Schnur
primaryScriptUri	URI für das Skript. Dies ist der Einstiegspunkt für das externe Skript.	Schnur
retentionInterval	Intervall, für das der Dienst die Skriptressource behält, nachdem er einen Terminalstatus erreicht hat. Die Ressource wird gelöscht, wenn diese Dauer abläuft. Die Dauer basiert auf dem ISO 8601-Muster (z. B. P1D bedeutet einen Tag).	Zeichenfolge (erforderlich)
scriptContent	Skripttext.	Schnur
storageAccountSettings	Speicherkontoeinstellungen.	StorageAccountConfiguration-
supportScriptUris	Unterstützende Dateien für das externe Skript.	string[]
Zeitüberschreitung	Maximal zulässige Skriptausführungszeit im ISO 8601-Format. Standardwert ist P1D	Schnur

ContainerConfiguration

Name	Beschreibung	Wert
containerGroupName	Containergruppenname, wenn nicht angegeben, wird der Name automatisch generiert. Kein Angeben eines "containerGroupName" gibt an, dass das System einen eindeutigen Namen generiert, der dazu führen kann, dass eine Azure-Richtlinie als nicht konform gekennzeichnet wird. Verwenden Sie "containerGroupName", wenn Sie über eine Azure-Richtlinie verfügen, die eine bestimmte Benennungskonvention erwartet oder wenn Sie den Namen vollständig steuern möchten. Die Eigenschaft "containerGroupName" muss zwischen 1 und 63 Zeichen lang sein, darf nur Kleinbuchstaben, Zahlen und Gedankenstriche enthalten, und sie darf nicht mit einem Gedankenstrich beginnen oder enden, und aufeinander folgende Striche sind nicht zulässig. Um einen 'containerGroupName' anzugeben, fügen Sie das folgende Objekt zu Eigenschaften hinzu: { "containerSettings": { "containerGroupName": "contoso-container" } }. Wenn Sie keinen 'containerGroupName' angeben möchten, fügen Sie keine 'containerSettings'-Eigenschaft hinzu.	Schnur Zwänge: Min. Länge = 1 Max. Länge = 63
Subnetz-ID	Die Subnetzressourcen-IDs für eine Containergruppe.	ContainerGroupSubnetId[]

ContainerGroupSubnetId

Name	Beschreibung	Wert
id	Ressourcen-ID des Subnetzes.	Zeichenfolge (erforderlich)
Name	Anzeigename für das Subnetz.	Schnur

EnvironmentVariable

Name	Beschreibung	Wert
Name	Der Name der Umgebungsvariable.	Zeichenfolge (erforderlich)
secureValue	Der Wert der Variablen für die sichere Umgebung.	Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter.
Wert	Der Wert der Umgebungsvariable.	Schnur

StorageAccountConfiguration

Name	Beschreibung	Wert
storageAccountKey	Der Zugriffsschlüssel für das Speicherkonto.	Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter.
storageAccountName	Der Name des Speicherkontos.	Schnur

AzurePowerShellScript

Name	Beschreibung	Wert
Art	Typ des Skripts.	"AzurePowerShell" (erforderlich)
Eigenschaften	Eigenschaften des Azure PowerShell-Skriptobjekts.	AzurePowerShellScriptProperties- (erforderlich)

AzurePowerShellScriptProperties

Name	Beschreibung	Wert
Argumente	Befehlszeilenargumente, die an das Skript übergeben werden sollen. Argumente werden durch Leerzeichen getrennt. z. B. -Name blau* -Location "West US 2"	Schnur
azPowerShellVersion	Zu verwendende Azure PowerShell-Modulversion.	Zeichenfolge (erforderlich)
cleanupPreference	Die Bereinigungseinstellung, wenn die Skriptausführung in einem Terminalzustand angezeigt wird. Die Standardeinstellung lautet "Immer".	"Immer" "OnExpiration" "OnSuccess"
containerSettings	Containereinstellungen.	ContainerConfiguration-
environmentVariables	Die Umgebungsvariablen, die an das Skript übergeben werden sollen.	EnvironmentVariable[]
forceUpdateTag	Ruft ab oder legt fest, wie das Bereitstellungsskript ausgeführt werden soll, auch wenn die Skriptressource nicht geändert wurde. Dies kann ein aktueller Zeitstempel oder eine GUID sein.	Schnur
primaryScriptUri	URI für das Skript. Dies ist der Einstiegspunkt für das externe Skript.	Schnur
retentionInterval	Intervall, für das der Dienst die Skriptressource behält, nachdem er einen Terminalstatus erreicht hat. Die Ressource wird gelöscht, wenn diese Dauer abläuft. Die Dauer basiert auf dem ISO 8601-Muster (z. B. P1D bedeutet einen Tag).	Zeichenfolge (erforderlich)
scriptContent	Skripttext.	Schnur
storageAccountSettings	Speicherkontoeinstellungen.	StorageAccountConfiguration-
supportScriptUris	Unterstützende Dateien für das externe Skript.	string[]
Zeitüberschreitung	Maximal zulässige Skriptausführungszeit im ISO 8601-Format. Standardwert ist P1D	Schnur

ManagedServiceIdentity

Name	Beschreibung	Wert
Art	Typ der verwalteten Identität.	"UserAssigned"
userAssignedIdentities	Die Liste der vom Benutzer zugewiesenen verwalteten Identitäten, die der Ressource zugeordnet sind. Der Schlüssel ist die Azure-Ressourcen-ID der verwalteten Identität.	ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name	Beschreibung	Wert
{angepasste Eigenschaft}		UserAssignedIdentity-

UserAssignedIdentity

Dieses Objekt enthält keine Eigenschaften, die während der Bereitstellung festgelegt werden sollen. Alle Eigenschaften sind ReadOnly.

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
min.io Azure Gateway-	Vollständig private min.io Azure Gateway-Bereitstellung, um eine S3-kompatible Speicher-API bereitzustellen, die durch BLOB-Speicher gesichert wird
Erstellen einer WordPress-Website	Diese Vorlage erstellt eine WordPress-Website auf containerinstanz
Azure Image Builder mit Azure Windows Baseline	Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit den neuesten Angewendeten Windows-Updates und Azure Windows Baseline.
Importieren von VHD-Blobs aus einer ZIP-Archiv-URL	Für die Bereitstellung virtueller Computer, die auf speziellen Datenträgerimages basieren, müssen VHD-Dateien in ein Speicherkonto importiert werden. Falls mehrere VHD-Dateien in einer einzelnen ZIP-Datei komprimiert sind und Sie die URL zum Abrufen des ZIP-Archivs erhalten haben, erleichtert diese ARM-Vorlage den Auftrag: Herunterladen, Extrahieren und Importieren in einen vorhandenen Blob-Container für Speicherkonten.
Kopieren einer Datei aus einem URI in einen BLOB-Speichercontainer	Dieses Modul lädt eine Datei aus einem URI herunter und kopiert sie in einen Azure storageAccount-BLOB-Container. Das storageAccount muss bereits vorhanden sein, und die Quelldatei muss bereits auf den URI eingestellt werden.
Erstellt eine Container-App und -Umgebung mit Registrierungs-	Erstellen Sie eine Container-App-Umgebung mit einer einfachen Container-App aus einer Azure-Containerregistrierung. Außerdem wird ein Log Analytics-Arbeitsbereich zum Speichern von Protokollen bereitgestellt.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps	Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Bereitstellen einer einfachen Azure Spring Apps Microservice-Anwendung	Diese Vorlage stellt eine einfache Azure Spring Apps Microservice-Anwendung bereit, die auf Azure ausgeführt werden kann.
Front Door Standard/Premium mit statischem Websiteursprung	Diese Vorlage erstellt eine Statische Azure Storage Standard/Premium-Website und eine statische Azure Storage-Website und konfiguriert Front Door, um Datenverkehr an die statische Website zu senden.
Erstellen eines ON-Demand-SFTP-Servers mit persistentem Speicher	Diese Vorlage veranschaulicht einen ON-Demand-SFTP-Server mit einer Azure Container Instance (ACI).
FinOps Hub-	Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Lake-Speicher und einer Data Factory.
Erstellen eines Blobs für das Datenfactory-Kopier-Datentool – Schnellstart	Diese Vorlage erstellt einen BLOB-Speicher und lädt eine Datei für das Schnellstartprogramm zum Kopieren von Daten hoch.
Mehr ist mit Azure Data Factory möglich – Ein Klick, um Azure Data Factory	Diese Vorlage erstellt eine Datenfactorypipeline für eine Kopieraktivität aus Azure Blob in ein anderes Azure Blob
Konfigurieren des Dev Box-Diensts	Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß Dev Box-Schnellstarthandbuch (https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box) erstellen. Sie können alle erstellten Ressourcen anzeigen oder direkt zu DevPortal.microsoft.com wechseln, um Ihr erstes Dev Box zu erstellen.
Azure Container Service (AKS) mit Helm	Bereitstellen eines verwalteten Clusters mit Azure Container Service (AKS) mit Helm
Erstellen eines Azure Machine Learning-Aufräumauftrags	Diese Vorlage erstellt einen Azure Machine Learning Sweep-Auftrag für die Hyperparameteroptimierung.
Testumgebung für Azure Firewall Premium	Diese Vorlage erstellt eine Azure Firewall Premium- und Firewallrichtlinie mit Premium-Features wie Intrusion Inspection Detection (IDPS), TLS-Inspektion und Webkategoriefilterung
Erstellen von Containerimages mit ACR-Aufgaben-	Diese Vorlage verwendet DeploymentScript, um ACR zu koordinieren, um Ihr Containerimage aus dem Code-Repository zu erstellen.
Containerimages in ACR- importieren	Diese Vorlage nutzt das Modul "Importieren von ACR" aus der Bicep-Registrierung, um öffentliche Containerimages in eine Azure-Containerregistrierung zu importieren.
Erstellen eines Anwendungsgateways mit Zertifikaten	Diese Vorlage zeigt, wie Sie selbstsignierte Key Vault-Zertifikate generieren und dann vom Anwendungsgateway referenzieren.
Verwenden eines Bereitstellungsskripts zum Erstellen von Azure AD-Objekten	In diesem Beispiel wird ein Bereitstellungsskript zum Erstellen von Objekten in Azure Active Directory verwendet.
Erstellen eines Bereitstellungsskripts mit komplexen Eingaben & Ausgaben	Diese Vorlage veranschaulicht bewährte Methoden zum Übergeben und Lesen komplexer Eingaben, Ausgaben und Protokolle an ein Az CLI-Bereitstellungsskript.
Erstellen eines Bereitstellungsskripts mit komplexen Eingaben & Ausgaben	Diese Vorlage veranschaulicht bewährte Methoden zum Übergeben und Lesen komplexer Eingaben, Ausgaben und Protokolle an ein Az Powershell-Bereitstellungsskript
Erstellen von SSH-Schlüsseln und Speichern in KeyVault	Diese Vorlage verwendet die DeploymentScript-Ressource, um SSH-Schlüssel zu generieren und den privaten Schlüssel in keyVault zu speichern.
Stellt eine statische Website	Stellt eine statische Website mit einem Sicherungsspeicherkonto bereit.
Funktions-App unter Linux-Verbrauchsplan mit RemoteBuild-	Diese Vorlage stellt eine Funktions-App in einem Linux-Verbrauchsplan bereit und führt während der Codebereitstellung Remotebuilds aus. Die App wird bei Bedarf ausgeführt, und Sie werden pro Ausführung abgerechnet, ohne ständige Ressourcenverpflichtung.
Erstellen eines Azure Virtual Network Manager und Beispiel-VNETs-	Diese Vorlage stellt einen Azure Virtual Network Manager bereit und stellt virtuelle Netzwerke in der benannten Ressourcengruppe bereit. Sie unterstützt mehrere Verbindungstopologien und Netzwerkgruppenmitgliedschaftstypen.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der DeploymentScripts-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Resources/deploymentScripts-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deploymentScripts@2023-08-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "UserAssigned"
    identity_ids = []
  }
  // For remaining properties, see deploymentScripts objects
  body = jsonencode({
    kind = "string"
  })
}

deploymentScripts-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AzureCLI:

  kind = "AzureCLI"
  properties = {
    arguments = "string"
    azCliVersion = "string"
    cleanupPreference = "string"
    containerSettings = {
      containerGroupName = "string"
      subnetIds = [
        {
          id = "string"
          name = "string"
        }
      ]
    }
    environmentVariables = [
      {
        name = "string"
        secureValue = "string"
        value = "string"
      }
    ]
    forceUpdateTag = "string"
    primaryScriptUri = "string"
    retentionInterval = "string"
    scriptContent = "string"
    storageAccountSettings = {
      storageAccountKey = "string"
      storageAccountName = "string"
    }
    supportingScriptUris = [
      "string"
    ]
    timeout = "string"
  }

Verwenden Sie für AzurePowerShell-:

  kind = "AzurePowerShell"
  properties = {
    arguments = "string"
    azPowerShellVersion = "string"
    cleanupPreference = "string"
    containerSettings = {
      containerGroupName = "string"
      subnetIds = [
        {
          id = "string"
          name = "string"
        }
      ]
    }
    environmentVariables = [
      {
        name = "string"
        secureValue = "string"
        value = "string"
      }
    ]
    forceUpdateTag = "string"
    primaryScriptUri = "string"
    retentionInterval = "string"
    scriptContent = "string"
    storageAccountSettings = {
      storageAccountKey = "string"
      storageAccountName = "string"
    }
    supportingScriptUris = [
      "string"
    ]
    timeout = "string"
  }

Eigenschaftswerte

deploymentScripts

Name	Beschreibung	Wert
Art	Der Ressourcentyp	"Microsoft.Resources/deploymentScripts@2023-08-01"
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Ort	Der Speicherort der ACI und des Speicherkontos für das Bereitstellungsskript.	Zeichenfolge (erforderlich)
parent_id	Verwenden Sie die ID dieser Ressourcengruppe, um sie in einer Ressourcengruppe bereitzustellen.	Zeichenfolge (erforderlich)
Schilder	Ressourcentags.	Wörterbuch der Tagnamen und -werte.
Art	Festlegen des Objekttyps	AzureCLI AzurePowerShell- (erforderlich)
Identität	Optionale Eigenschaft. Verwaltete Identität, die für dieses Bereitstellungsskript verwendet werden soll. Derzeit wird nur vom Benutzer zugewiesene MSI unterstützt.	ManagedServiceIdentity-

AzureCliScript

Name	Beschreibung	Wert
Art	Typ des Skripts.	"AzureCLI" (erforderlich)
Eigenschaften	Eigenschaften des Azure CLI-Skriptobjekts.	AzureCliScriptProperties- (erforderlich)

AzureCliScriptProperties

Name	Beschreibung	Wert
Argumente	Befehlszeilenargumente, die an das Skript übergeben werden sollen. Argumente werden durch Leerzeichen getrennt. z. B. -Name blau* -Location "West US 2"	Schnur
azCliVersion	Zu verwendende Azure CLI-Modulversion.	Zeichenfolge (erforderlich)
cleanupPreference	Die Bereinigungseinstellung, wenn die Skriptausführung in einem Terminalzustand angezeigt wird. Die Standardeinstellung lautet "Immer".	"Immer" "OnExpiration" "OnSuccess"
containerSettings	Containereinstellungen.	ContainerConfiguration-
environmentVariables	Die Umgebungsvariablen, die an das Skript übergeben werden sollen.	EnvironmentVariable[]
forceUpdateTag	Ruft ab oder legt fest, wie das Bereitstellungsskript ausgeführt werden soll, auch wenn die Skriptressource nicht geändert wurde. Dies kann ein aktueller Zeitstempel oder eine GUID sein.	Schnur
primaryScriptUri	URI für das Skript. Dies ist der Einstiegspunkt für das externe Skript.	Schnur
retentionInterval	Intervall, für das der Dienst die Skriptressource behält, nachdem er einen Terminalstatus erreicht hat. Die Ressource wird gelöscht, wenn diese Dauer abläuft. Die Dauer basiert auf dem ISO 8601-Muster (z. B. P1D bedeutet einen Tag).	Zeichenfolge (erforderlich)
scriptContent	Skripttext.	Schnur
storageAccountSettings	Speicherkontoeinstellungen.	StorageAccountConfiguration-
supportScriptUris	Unterstützende Dateien für das externe Skript.	string[]
Zeitüberschreitung	Maximal zulässige Skriptausführungszeit im ISO 8601-Format. Standardwert ist P1D	Schnur

ContainerConfiguration

Name	Beschreibung	Wert
containerGroupName	Containergruppenname, wenn nicht angegeben, wird der Name automatisch generiert. Kein Angeben eines "containerGroupName" gibt an, dass das System einen eindeutigen Namen generiert, der dazu führen kann, dass eine Azure-Richtlinie als nicht konform gekennzeichnet wird. Verwenden Sie "containerGroupName", wenn Sie über eine Azure-Richtlinie verfügen, die eine bestimmte Benennungskonvention erwartet oder wenn Sie den Namen vollständig steuern möchten. Die Eigenschaft "containerGroupName" muss zwischen 1 und 63 Zeichen lang sein, darf nur Kleinbuchstaben, Zahlen und Gedankenstriche enthalten, und sie darf nicht mit einem Gedankenstrich beginnen oder enden, und aufeinander folgende Striche sind nicht zulässig. Um einen 'containerGroupName' anzugeben, fügen Sie das folgende Objekt zu Eigenschaften hinzu: { "containerSettings": { "containerGroupName": "contoso-container" } }. Wenn Sie keinen 'containerGroupName' angeben möchten, fügen Sie keine 'containerSettings'-Eigenschaft hinzu.	Schnur Zwänge: Min. Länge = 1 Max. Länge = 63
Subnetz-ID	Die Subnetzressourcen-IDs für eine Containergruppe.	ContainerGroupSubnetId[]

ContainerGroupSubnetId

Name	Beschreibung	Wert
id	Ressourcen-ID des Subnetzes.	Zeichenfolge (erforderlich)
Name	Anzeigename für das Subnetz.	Schnur

EnvironmentVariable

Name	Beschreibung	Wert
Name	Der Name der Umgebungsvariable.	Zeichenfolge (erforderlich)
secureValue	Der Wert der Variablen für die sichere Umgebung.	Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter.
Wert	Der Wert der Umgebungsvariable.	Schnur

StorageAccountConfiguration

Name	Beschreibung	Wert
storageAccountKey	Der Zugriffsschlüssel für das Speicherkonto.	Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter.
storageAccountName	Der Name des Speicherkontos.	Schnur

AzurePowerShellScript

Name	Beschreibung	Wert
Art	Typ des Skripts.	"AzurePowerShell" (erforderlich)
Eigenschaften	Eigenschaften des Azure PowerShell-Skriptobjekts.	AzurePowerShellScriptProperties- (erforderlich)

AzurePowerShellScriptProperties

Name	Beschreibung	Wert
Argumente	Befehlszeilenargumente, die an das Skript übergeben werden sollen. Argumente werden durch Leerzeichen getrennt. z. B. -Name blau* -Location "West US 2"	Schnur
azPowerShellVersion	Zu verwendende Azure PowerShell-Modulversion.	Zeichenfolge (erforderlich)
cleanupPreference	Die Bereinigungseinstellung, wenn die Skriptausführung in einem Terminalzustand angezeigt wird. Die Standardeinstellung lautet "Immer".	"Immer" "OnExpiration" "OnSuccess"
containerSettings	Containereinstellungen.	ContainerConfiguration-
environmentVariables	Die Umgebungsvariablen, die an das Skript übergeben werden sollen.	EnvironmentVariable[]
forceUpdateTag	Ruft ab oder legt fest, wie das Bereitstellungsskript ausgeführt werden soll, auch wenn die Skriptressource nicht geändert wurde. Dies kann ein aktueller Zeitstempel oder eine GUID sein.	Schnur
primaryScriptUri	URI für das Skript. Dies ist der Einstiegspunkt für das externe Skript.	Schnur
retentionInterval	Intervall, für das der Dienst die Skriptressource behält, nachdem er einen Terminalstatus erreicht hat. Die Ressource wird gelöscht, wenn diese Dauer abläuft. Die Dauer basiert auf dem ISO 8601-Muster (z. B. P1D bedeutet einen Tag).	Zeichenfolge (erforderlich)
scriptContent	Skripttext.	Schnur
storageAccountSettings	Speicherkontoeinstellungen.	StorageAccountConfiguration-
supportScriptUris	Unterstützende Dateien für das externe Skript.	string[]
Zeitüberschreitung	Maximal zulässige Skriptausführungszeit im ISO 8601-Format. Standardwert ist P1D	Schnur

ManagedServiceIdentity

Name	Beschreibung	Wert
Art	Typ der verwalteten Identität.	"UserAssigned"
identity_ids	Die Liste der vom Benutzer zugewiesenen verwalteten Identitäten, die der Ressource zugeordnet sind. Der Schlüssel ist die Azure-Ressourcen-ID der verwalteten Identität.	Array von Benutzeridentitäts-IDs.

ManagedServiceIdentityUserAssignedIdentities

Name	Beschreibung	Wert
{angepasste Eigenschaft}		UserAssignedIdentity-

UserAssignedIdentity

Dieses Objekt enthält keine Eigenschaften, die während der Bereitstellung festgelegt werden sollen. Alle Eigenschaften sind ReadOnly.

Freigeben über

Microsoft.Resources deploymentScripts

Bicep-Ressourcendefinition

Bemerkungen

Ressourcenformat

deploymentScripts-Objekte

Eigenschaftswerte

deploymentScripts

AzureCliScript

AzureCliScriptProperties

ContainerConfiguration

ContainerGroupSubnetId

EnvironmentVariable

StorageAccountConfiguration

AzurePowerShellScript

AzurePowerShellScriptProperties

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

UserAssignedIdentity

Schnellstartvorlagen

ARM-Vorlagenressourcendefinition

Bemerkungen

Ressourcenformat

deploymentScripts-Objekte

Eigenschaftswerte

deploymentScripts

AzureCliScript

AzureCliScriptProperties

ContainerConfiguration

ContainerGroupSubnetId

EnvironmentVariable

StorageAccountConfiguration

AzurePowerShellScript

AzurePowerShellScriptProperties

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

UserAssignedIdentity

Schnellstartvorlagen

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Ressourcenformat

deploymentScripts-Objekte

Eigenschaftswerte

deploymentScripts

AzureCliScript

AzureCliScriptProperties

ContainerConfiguration

ContainerGroupSubnetId

EnvironmentVariable

StorageAccountConfiguration

AzurePowerShellScript

AzurePowerShellScriptProperties

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

UserAssignedIdentity

Feedback

Zusätzliche Ressourcen