Freigeben über


Microsoft.Resources deploymentScripts

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.

Bicep-Ressourcendefinition

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

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 den folgenden Bicep hinzu.

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

Microsoft.Resources/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

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

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

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 = 1
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

DeploymentScriptTags

Name Beschreibung Wert

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

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

Microsoft.Resources/deploymentScripts

Name Beschreibung Wert
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-
Art Legen Sie für den Typ AzureCliScript-auf "AzureCLI" fest. Legen Sie für den Typ AzurePowerShellScript-auf "AzurePowerShell" fest. "AzureCLI"
"AzurePowerShell" (erforderlich)
Ort Der Speicherort der ACI und des Speicherkontos für das Bereitstellungsskript. Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1 (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

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

UserAssignedIdentity

Name Beschreibung Wert

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
Azure Container Service (AKS) mit Helm Bereitstellen eines verwalteten Clusters mit Azure Container Service (AKS) mit Helm
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.
Erstellen von Containerimages mit ACR-Aufgaben- Diese Vorlage verwendet DeploymentScript, um ACR zu koordinieren, um Ihr Containerimage aus dem Code-Repository zu erstellen.
Konfigurieren des Dev Box-Diensts Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstarthandbuch (/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.
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.
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.
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 einer WordPress-Website Diese Vorlage erstellt eine WordPress-Website auf containerinstanz
Erstellen von AKS mit Prometheus und Grafana mit privae link Dadurch wird ein Azure Grafana, AKS und Prometheus, ein Open Source Monitoring and Alerting Toolkit, auf einem Azure Kubernetes Service (AKS)-Cluster erstellt. Anschließend verwenden Sie den verwalteten privaten Endpunkt von Azure Managed Grafana, um eine Verbindung mit diesem Prometheus-Server herzustellen und die Prometheus-Daten in einem Grafana-Dashboard anzuzeigen.
Erstellen eines Azure Machine Learning-Aufräumauftrags Diese Vorlage erstellt einen Azure Machine Learning Sweep-Auftrag für die Hyperparameteroptimierung.
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.
Erstellen eines ON-Demand-SFTP-Servers mit persistentem Speicher Diese Vorlage veranschaulicht einen ON-Demand-SFTP-Server mit einer Azure Container Instance (ACI).
Erstellen eines Anwendungsgateways mit Zertifikaten Diese Vorlage zeigt, wie Sie selbstsignierte Key Vault-Zertifikate generieren und dann vom Anwendungsgateway referenzieren.
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 Microservices-App mit Container-Apps Erstellen Sie eine Dapr Microservices-App mit Container-Apps.
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.
Stellt eine statische Website Stellt eine statische Website mit einem Sicherungsspeicherkonto bereit.
FinOps Hub- Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Lake-Speicher und einer Data Factory.
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.
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.
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
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
Verwenden eines Bereitstellungsskripts zum Erstellen von Azure AD-Objekten In diesem Beispiel wird ein Bereitstellungsskript zum Erstellen von Objekten in Azure Active Directory verwendet.

ARM-Vorlagenressourcendefinition

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

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 den folgenden JSON-Code hinzu.

{
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "name": "string",
  "tags": {
    "{customized property}": "string"
  },
  "kind": "string"
  // For remaining properties, see Microsoft.Resources/deploymentScripts objects
}

Microsoft.Resources/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

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

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

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 = 1
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

DeploymentScriptTags

Name Beschreibung Wert

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

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

Microsoft.Resources/deploymentScripts

Name Beschreibung Wert
apiVersion Die API-Version '2023-08-01'
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-
Art Legen Sie für den Typ AzureCliScript-auf "AzureCLI" fest. Legen Sie für den Typ AzurePowerShellScript-auf "AzurePowerShell" fest. "AzureCLI"
"AzurePowerShell" (erforderlich)
Ort Der Speicherort der ACI und des Speicherkontos für das Bereitstellungsskript. Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1 (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.Resources/deploymentScripts"

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

UserAssignedIdentity

Name Beschreibung Wert

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Azure Container Service (AKS) mit Helm

Bereitstellen in Azure
Bereitstellen eines verwalteten Clusters mit Azure Container Service (AKS) mit Helm
Azure Image Builder mit Azure Windows Baseline

Bereitstellen in Azure
Erstellt eine Azure Image Builder-Umgebung und erstellt ein Windows Server-Image mit den neuesten Angewendeten Windows-Updates und Azure Windows Baseline.
Erstellen von Containerimages mit ACR-Aufgaben-

Bereitstellen in Azure
Diese Vorlage verwendet DeploymentScript, um ACR zu koordinieren, um Ihr Containerimage aus dem Code-Repository zu erstellen.
Konfigurieren des Dev Box-Diensts

Bereitstellen in Azure
Diese Vorlage würde alle Dev Box-Administratorressourcen gemäß dev Box-Schnellstarthandbuch (/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.
Kopieren einer Datei aus einem URI in einen BLOB-Speichercontainer

Bereitstellen in Azure
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.
Erstellen eines Blobs für das Datenfactory-Kopier-Datentool – Schnellstart

Bereitstellen in Azure
Diese Vorlage erstellt einen BLOB-Speicher und lädt eine Datei für das Schnellstartprogramm zum Kopieren von Daten hoch.
Erstellen eines Bereitstellungsskripts mit komplexen Eingaben & Ausgaben

Bereitstellen in Azure
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

Bereitstellen in Azure
Diese Vorlage veranschaulicht bewährte Methoden zum Übergeben und Lesen komplexer Eingaben, Ausgaben und Protokolle an ein Az Powershell-Bereitstellungsskript
Erstellen einer WordPress-Website

Bereitstellen in Azure
Diese Vorlage erstellt eine WordPress-Website auf containerinstanz
Erstellen von AKS mit Prometheus und Grafana mit privae link

Bereitstellen in Azure
Dadurch wird ein Azure Grafana, AKS und Prometheus, ein Open Source Monitoring and Alerting Toolkit, auf einem Azure Kubernetes Service (AKS)-Cluster erstellt. Anschließend verwenden Sie den verwalteten privaten Endpunkt von Azure Managed Grafana, um eine Verbindung mit diesem Prometheus-Server herzustellen und die Prometheus-Daten in einem Grafana-Dashboard anzuzeigen.
Erstellen eines Azure Machine Learning-Aufräumauftrags

Bereitstellen in Azure
Diese Vorlage erstellt einen Azure Machine Learning Sweep-Auftrag für die Hyperparameteroptimierung.
Erstellen eines Azure Virtual Network Manager und Beispiel-VNETs-

Bereitstellen in Azure
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.
Erstellen eines ON-Demand-SFTP-Servers mit persistentem Speicher

Bereitstellen in Azure
Diese Vorlage veranschaulicht einen ON-Demand-SFTP-Server mit einer Azure Container Instance (ACI).
Erstellen eines Anwendungsgateways mit Zertifikaten

Bereitstellen in Azure
Diese Vorlage zeigt, wie Sie selbstsignierte Key Vault-Zertifikate generieren und dann vom Anwendungsgateway referenzieren.
Erstellen von SSH-Schlüsseln und Speichern in KeyVault

Bereitstellen in Azure
Diese Vorlage verwendet die DeploymentScript-Ressource, um SSH-Schlüssel zu generieren und den privaten Schlüssel in keyVault zu speichern.
Erstellt eine Container-App und -Umgebung mit Registrierungs-

Bereitstellen in Azure
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 Microservices-App mit Container-Apps

Bereitstellen in Azure
Erstellen Sie eine Dapr Microservices-App mit Container-Apps.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps

Bereitstellen in Azure
Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Bereitstellen einer einfachen Azure Spring Apps Microservice-Anwendung

Bereitstellen in Azure
Diese Vorlage stellt eine einfache Azure Spring Apps Microservice-Anwendung bereit, die auf Azure ausgeführt werden kann.
Stellt eine statische Website

Bereitstellen in Azure
Stellt eine statische Website mit einem Sicherungsspeicherkonto bereit.
FinOps Hub-

Bereitstellen in Azure
Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Lake-Speicher und einer Data Factory.
Front Door Standard/Premium mit statischem Websiteursprung

Bereitstellen in Azure
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.
Funktions-App unter Linux-Verbrauchsplan mit RemoteBuild-

Bereitstellen in Azure
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.
Containerimages in ACR- importieren

Bereitstellen in Azure
Diese Vorlage nutzt das Modul "Importieren von ACR" aus der Bicep-Registrierung, um öffentliche Containerimages in eine Azure-Containerregistrierung zu importieren.
Importieren von VHD-Blobs aus einer ZIP-Archiv-URL

Bereitstellen in Azure
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.
min.io Azure Gateway-

Bereitstellen in Azure
Vollständig private min.io Azure Gateway-Bereitstellung, um eine S3-kompatible Speicher-API bereitzustellen, die durch BLOB-Speicher gesichert wird
Mehr ist mit Azure Data Factory möglich – Ein Klick, um Azure Data Factory

Bereitstellen in Azure
Diese Vorlage erstellt eine Datenfactorypipeline für eine Kopieraktivität aus Azure Blob in ein anderes Azure Blob
Testumgebung für Azure Firewall Premium

Bereitstellen in Azure
Diese Vorlage erstellt eine Azure Firewall Premium- und Firewallrichtlinie mit Premium-Features wie Intrusion Inspection Detection (IDPS), TLS-Inspektion und Webkategoriefilterung
Verwenden eines Bereitstellungsskripts zum Erstellen von Azure AD-Objekten

Bereitstellen in Azure
In diesem Beispiel wird ein Bereitstellungsskript zum Erstellen von Objekten in Azure Active Directory verwendet.

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" {
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  name = "string"
  tags = {
    {customized property} = "string"
  }
  kind = "string"
  // For remaining properties, see Microsoft.Resources/deploymentScripts objects
}

Microsoft.Resources/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

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

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

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 = 1
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

DeploymentScriptTags

Name Beschreibung Wert

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

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

Microsoft.Resources/deploymentScripts

Name Beschreibung Wert
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-
Art Legen Sie für den Typ AzureCliScript-auf "AzureCLI" fest. Legen Sie für den Typ AzurePowerShellScript-auf "AzurePowerShell" fest. "AzureCLI"
"AzurePowerShell" (erforderlich)
Ort Der Speicherort der ACI und des Speicherkontos für das Bereitstellungsskript. Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

Zwänge:
Min. Länge = 1
Max. Länge = 1 (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.Resources/deploymentScripts@2023-08-01"

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

UserAssignedIdentity

Name Beschreibung Wert