Microsoft.Compute virtualMachines/extensions 2021-03-01
Bicep-Ressourcendefinition
Der Ressourcentyp virtualMachines/extensions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/virtualMachines/extensions-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2021-03-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
autoUpgradeMinorVersion: bool
enableAutomaticUpgrade: bool
forceUpdateTag: 'string'
instanceView: {
name: 'string'
statuses: [
{
code: 'string'
displayStatus: 'string'
level: 'string'
message: 'string'
time: 'string'
}
]
substatuses: [
{
code: 'string'
displayStatus: 'string'
level: 'string'
message: 'string'
time: 'string'
}
]
type: 'string'
typeHandlerVersion: 'string'
}
protectedSettings: any()
publisher: 'string'
settings: any()
type: 'string'
typeHandlerVersion: 'string'
}
}
Eigenschaftswerte
virtualMachines/extensions
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Ressourcenname Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep. |
Zeichenfolge (erforderlich) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen. |
parent | In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource. |
Symbolischer Name für Ressource vom Typ : virtualMachines |
properties | Beschreibt die Eigenschaften einer VM-Erweiterung. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
autoUpgradeMinorVersion | Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zum Zeitpunkt der Bereitstellung verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf „true“ festgelegt ist. | bool |
enableAutomaticUpgrade | Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. | bool |
forceUpdateTag | Wie der Erweiterungshandler zum Aktualisieren gezwungen werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. | Zeichenfolge |
instanceView | Die VM-Erweiterung instance Ansicht. | VirtualMachineExtensionInstanceView |
protectedSettings | Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. | Für Bicep können Sie die funktion any() verwenden. |
publisher | Der Name des Erweiterungshandlerherausgebers. | Zeichenfolge |
settings | Im Json-Format formatierte öffentliche Einstellungen für die Erweiterung. | Für Bicep können Sie die funktion any() verwenden. |
Typ | Gibt den Typ der Erweiterung an. Ein Beispiel ist "CustomScriptExtension". | Zeichenfolge |
typeHandlerVersion | Gibt die Version des Skripthandlers an. | Zeichenfolge |
VirtualMachineExtensionInstanceView
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Name der VM-Erweiterung. | Zeichenfolge |
statuses | Die Ressource status Informationen. | InstanceViewStatus[] |
substatuses | Die Ressource status Informationen. | InstanceViewStatus[] |
Typ | Gibt den Typ der Erweiterung an. Ein Beispiel ist "CustomScriptExtension". | Zeichenfolge |
typeHandlerVersion | Gibt die Version des Skripthandlers an. | Zeichenfolge |
InstanceViewStatus
Name | BESCHREIBUNG | Wert |
---|---|---|
code | Der Statuscode. | Zeichenfolge |
displayStatus | Die kurze lokalisierbare Bezeichnung für die status. | Zeichenfolge |
Level | Der Ebenencode. | "Fehler" 'Info' "Warnung" |
message | Die detaillierte status Meldung, einschließlich Warnungen und Fehlermeldungen. | Zeichenfolge |
time | Die Zeit der status. | Zeichenfolge |
Schnellstartvorlagen
In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
Erstellen einer Windows-VM mit aktivierter Anti-Malware-Erweiterung |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet den Schutz vor Antischadsoftware ein. |
IIS-Server mit DSC-Erweiterung auf einem virtuellen Windows-Computer |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet mithilfe der DSC-Erweiterung einen IIS-Server ein. Beachten Sie, dass für das DSC-Konfigurationsmodul ein SAS-Token übergeben werden muss, wenn Sie Azure Storage verwenden. Für den DSC-Modullink von GitHub (Standard in dieser Vorlage) ist dies nicht erforderlich. |
ESET-VM-Erweiterung |
Erstellt einen virtuellen Computer mit DER ESET-Erweiterung |
McAfee Endpoint Security (Testlizenz) auf Windows-VM |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet eine Testversion von McAfee Endpoint Security ein. |
Bereitstellen einer Ubuntu-VM mit der OMS-Erweiterung |
Mit dieser Vorlage können Sie einen virtuellen Ubuntu-Computer bereitstellen, bei dem die OMS-Erweiterung installiert und in einem angegebenen Arbeitsbereich integriert ist. |
Bereitstellen eines virtuellen Windows-Computers mit der OMS-Erweiterung |
Mit dieser Vorlage können Sie einen virtuellen Windows-Computer bereitstellen, bei dem die OMS-Erweiterung installiert und in einem angegebenen Arbeitsbereich integriert ist. |
Testversion der Symantec Endpoint Protection-Erweiterung auf einem virtuellen Windows-Computer |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet eine Testversion von Symantec Endpoint Protection ein. |
Benutzerdefinierte Skripterweiterung auf einem virtuellen Ubuntu-Computer |
Diese Vorlage erstellt einen virtuellen Ubuntu-Computer und installiert die CustomScript-Erweiterung. |
Betriebssystempatcherweiterung auf einem virtuellen Ubuntu-Computer |
Diese Vorlage erstellt einen virtuellen Ubuntu-Computer und installiert die OSPatching-Erweiterung. |
Bereitstellen einer Premium-Windows-VM mit Diagnose |
Mit dieser Vorlage können Sie einen virtuellen Windows-Premium-Computer mithilfe verschiedener Optionen für die Windows-Version bereitstellen, wobei die neueste gepatchte Version verwendet wird. |
Bereitstellen einer einfachen Windows-VM mit Überwachung und Diagnose |
Mit dieser Vorlage können Sie eine einfache Windows-VM zusammen mit der Diagnose-Erweiterung bereitstellen, die überwachung und Diagnose für den virtuellen Computer ermöglicht. |
Verwenden von Skripterweiterungen zum Installieren von Mongo DB auf Ubuntu-VM |
Mit dieser Vorlage wird Mongo DB auf einem virtuellen Ubuntu-Computer in zwei separaten Skripts konfiguriert und installiert. Diese Vorlage ist ein gutes Beispiel, das zeigt, wie Abhängigkeiten zwischen zwei Skripts ausgedrückt werden, die auf demselben virtuellen Computer ausgeführt werden. Diese Vorlage stellt auch ein Speicherkonto, Virtual Network, öffentliche IP-Adressen und eine Netzwerkschnittstelle bereit. |
Ressourcendefinition mit einer ARM-Vorlage
Der Ressourcentyp virtualMachines/extensions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.
Ressourcenformat
Um eine Ressource Microsoft.Compute/virtualMachines/extensions zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2021-03-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"autoUpgradeMinorVersion": "bool",
"enableAutomaticUpgrade": "bool",
"forceUpdateTag": "string",
"instanceView": {
"name": "string",
"statuses": [
{
"code": "string",
"displayStatus": "string",
"level": "string",
"message": "string",
"time": "string"
}
],
"substatuses": [
{
"code": "string",
"displayStatus": "string",
"level": "string",
"message": "string",
"time": "string"
}
],
"type": "string",
"typeHandlerVersion": "string"
},
"protectedSettings": {},
"publisher": "string",
"settings": {},
"type": "string",
"typeHandlerVersion": "string"
}
}
Eigenschaftswerte
virtualMachines/extensions
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Der Ressourcentyp | "Microsoft.Compute/virtualMachines/extensions" |
apiVersion | Die Version der Ressourcen-API | '2021-03-01' |
name | Der Ressourcenname Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen. |
Zeichenfolge (erforderlich) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen. |
properties | Beschreibt die Eigenschaften einer VM-Erweiterung. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
autoUpgradeMinorVersion | Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zum Zeitpunkt der Bereitstellung verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf „true“ festgelegt ist. | bool |
enableAutomaticUpgrade | Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. | bool |
forceUpdateTag | Wie der Erweiterungshandler zum Aktualisieren gezwungen werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. | Zeichenfolge |
instanceView | Die VM-Erweiterung instance Ansicht. | VirtualMachineExtensionInstanceView |
protectedSettings | Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder überhaupt keine geschützten Einstellungen enthalten. | |
publisher | Der Name des Erweiterungshandlerherausgebers. | Zeichenfolge |
settings | Json-formatierte öffentliche Einstellungen für die Erweiterung. | |
Typ | Gibt den Typ der Erweiterung an. ein Beispiel ist "CustomScriptExtension". | Zeichenfolge |
typeHandlerVersion | Gibt die Version des Skripthandlers an. | Zeichenfolge |
VirtualMachineExtensionInstanceView
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Name der VM-Erweiterung. | Zeichenfolge |
statuses | Die Ressource status Informationen. | InstanceViewStatus[] |
Unterstatus | Die Ressource status Informationen. | InstanceViewStatus[] |
Typ | Gibt den Typ der Erweiterung an. ein Beispiel ist "CustomScriptExtension". | Zeichenfolge |
typeHandlerVersion | Gibt die Version des Skripthandlers an. | Zeichenfolge |
InstanceViewStatus
Name | BESCHREIBUNG | Wert |
---|---|---|
code | Der Statuscode. | Zeichenfolge |
displayStatus | Die kurze lokalisierbare Bezeichnung für die status. | Zeichenfolge |
Level | Der Ebenencode. | "Fehler" "Info" "Warnung" |
message | Die detaillierte status Meldung, einschließlich Warnungen und Fehlermeldungen. | Zeichenfolge |
time | Die Zeit des status. | Zeichenfolge |
Schnellstartvorlagen
Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.
Vorlage | BESCHREIBUNG |
---|---|
Erstellen einer Windows-VM mit aktivierter Anti-Malware-Erweiterung |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet den Anti-Malware-Schutz ein. |
IIS-Server mithilfe der DSC-Erweiterung auf einem virtuellen Windows-Computer |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet einen IIS-Server mithilfe der DSC-Erweiterung ein. Beachten Sie, dass für das DSC-Konfigurationsmodul ein SAS-Token übergeben werden muss, wenn Sie Azure Storage verwenden. Für den DSC-Modullink von GitHub (Standard in dieser Vorlage) ist dies nicht erforderlich. |
ESET-VM-Erweiterung |
Erstellt einen virtuellen Computer mit der ESET-Erweiterung |
McAfee Endpoint Security (Testlizenz) auf einem virtuellen Windows-Computer |
Mit dieser Vorlage wird eine Windows-VM erstellt und eine Testversion von McAfee Endpoint Security eingerichtet. |
Bereitstellen einer Ubuntu-VM mit der OMS-Erweiterung |
Mit dieser Vorlage können Sie einen virtuellen Ubuntu-Computer bereitstellen, bei dem die OMS-Erweiterung installiert und in einem angegebenen Arbeitsbereich integriert ist. |
Bereitstellen einer Windows-VM mit der OMS-Erweiterung |
Mit dieser Vorlage können Sie einen virtuellen Windows-Computer bereitstellen, bei dem die OMS-Erweiterung installiert und in einem angegebenen Arbeitsbereich integriert ist. |
Symantec Endpoint Protection-Erweiterungstest auf einem virtuellen Windows-Computer |
Diese Vorlage erstellt einen virtuellen Windows-Computer und richtet eine Testversion von Symantec Endpoint Protection ein. |
Benutzerdefinierte Skripterweiterung auf einer Ubuntu-VM |
Diese Vorlage erstellt einen virtuellen Ubuntu-Computer und installiert die CustomScript-Erweiterung. |
Betriebssystempatcherweiterung auf einer Ubuntu-VM |
Diese Vorlage erstellt einen virtuellen Ubuntu-Computer und installiert die OSPatching-Erweiterung. |
Bereitstellen einer Windows-Premium-VM mit Diagnose |
Mit dieser Vorlage können Sie einen virtuellen Windows-Premium-Computer mit verschiedenen Optionen für die Windows-Version bereitstellen, wobei die neueste gepatchte Version verwendet wird. |
Bereitstellen einer einfachen Windows-VM mit Überwachung und Diagnose |
Mit dieser Vorlage können Sie eine einfache Windows-VM zusammen mit der Diagnose-Erweiterung bereitstellen, die überwachung und Diagnose für den virtuellen Computer ermöglicht. |
Verwenden von Skripterweiterungen zum Installieren von Mongo DB auf Ubuntu-VM |
Mit dieser Vorlage wird Mongo DB auf einem virtuellen Ubuntu-Computer in zwei separaten Skripts konfiguriert und installiert. Diese Vorlage ist ein gutes Beispiel, das zeigt, wie Abhängigkeiten zwischen zwei Skripts ausgedrückt werden, die auf demselben virtuellen Computer ausgeführt werden. Diese Vorlage stellt auch ein Speicherkonto, Virtual Network, öffentliche IP-Adressen und eine Netzwerkschnittstelle bereit. |
Terraform-Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp virtualMachines/extensions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Compute/virtualMachines/extensions-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Terraform-Ressource hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/virtualMachines/extensions@2021-03-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
autoUpgradeMinorVersion = bool
enableAutomaticUpgrade = bool
forceUpdateTag = "string"
instanceView = {
name = "string"
statuses = [
{
code = "string"
displayStatus = "string"
level = "string"
message = "string"
time = "string"
}
]
substatuses = [
{
code = "string"
displayStatus = "string"
level = "string"
message = "string"
time = "string"
}
]
type = "string"
typeHandlerVersion = "string"
}
publisher = "string"
type = "string"
typeHandlerVersion = "string"
}
})
}
Eigenschaftswerte
virtualMachines/extensions
Name | BESCHREIBUNG | Wert |
---|---|---|
type | Der Ressourcentyp | "Microsoft.Compute/virtualMachines/extensions@2021-03-01" |
name | Der Ressourcenname | Zeichenfolge (erforderlich) |
location | Ressourcenspeicherort | Zeichenfolge (erforderlich) |
parent_id | Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. | ID für Ressource vom Typ : virtualMachines |
tags | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
properties | Beschreibt die Eigenschaften einer VM-Erweiterung. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
Name | BESCHREIBUNG | Wert |
---|---|---|
autoUpgradeMinorVersion | Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zum Zeitpunkt der Bereitstellung verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf „true“ festgelegt ist. | bool |
enableAutomaticUpgrade | Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. | bool |
forceUpdateTag | Wie der Erweiterungshandler zum Aktualisieren gezwungen werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. | Zeichenfolge |
instanceView | Die VM-Erweiterung instance Ansicht. | VirtualMachineExtensionInstanceView |
protectedSettings | Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. | |
publisher | Der Name des Erweiterungshandlerherausgebers. | Zeichenfolge |
settings | Im Json-Format formatierte öffentliche Einstellungen für die Erweiterung. | |
Typ | Gibt den Typ der Erweiterung an. Ein Beispiel ist "CustomScriptExtension". | Zeichenfolge |
typeHandlerVersion | Gibt die Version des Skripthandlers an. | Zeichenfolge |
VirtualMachineExtensionInstanceView
Name | BESCHREIBUNG | Wert |
---|---|---|
name | Der Name der VM-Erweiterung. | Zeichenfolge |
statuses | Die Ressource status Informationen. | InstanceViewStatus[] |
substatuses | Die Ressource status Informationen. | InstanceViewStatus[] |
Typ | Gibt den Typ der Erweiterung an. Ein Beispiel ist "CustomScriptExtension". | Zeichenfolge |
typeHandlerVersion | Gibt die Version des Skripthandlers an. | Zeichenfolge |
InstanceViewStatus
Name | BESCHREIBUNG | Wert |
---|---|---|
code | Der Statuscode. | Zeichenfolge |
displayStatus | Die kurze lokalisierbare Bezeichnung für die status. | Zeichenfolge |
Level | Der Ebenencode. | "Fehler" "Info" "Warning" |
message | Die detaillierte status Meldung, einschließlich Warnungen und Fehlermeldungen. | Zeichenfolge |
time | Die Zeit der status. | Zeichenfolge |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für