Microsoft.Compute virtualMachines/extensions 2023-09-01
Definición de recursos de Bicep
El tipo de recurso virtualMachines/extensions se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Compute/virtualMachines/extensions, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2023-09-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()
protectedSettingsFromKeyVault: {
secretUrl: 'string'
sourceVault: {
id: 'string'
}
}
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any()
suppressFailures: bool
type: 'string'
typeHandlerVersion: 'string'
}
}
Valores de propiedad
virtualMachines/extensions
Nombre | Descripción | Valor |
---|---|---|
nombre | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
string (obligatorio) |
ubicación | Ubicación del recurso | cuerda |
Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
padre | En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: virtualMachines |
Propiedades | Describe las propiedades de una extensión de máquina virtual. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
Nombre | Descripción | Valor |
---|---|---|
autoUpgradeMinorVersion | Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. | Bool |
enableAutomaticUpgrade | Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. | Bool |
forceUpdateTag | Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. | cuerda |
instanceView | Vista de instancia de extensión de máquina virtual. | virtualMachineExtensionInstanceView |
protectedSettings | La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. | Para Bicep, puede usar la función any() |
protectedSettingsFromKeyVault | Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. | keyVaultSecretReference |
provisionAfterExtensions | Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. | string[] |
editor | Nombre del publicador de controladores de extensión. | cuerda |
Configuración | Configuración pública con formato JSON para la extensión. | Para Bicep, puede usar la función any() |
suppressFailures | Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. | Bool |
tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda |
typeHandlerVersion | Especifica la versión del controlador de script. | cuerda |
VirtualMachineExtensionInstanceView
Nombre | Descripción | Valor |
---|---|---|
nombre | Nombre de la extensión de máquina virtual. | cuerda |
Estados | Información de estado del recurso. | InstanceViewStatus[] |
subestados | Información de estado del recurso. | InstanceViewStatus[] |
tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda |
typeHandlerVersion | Especifica la versión del controlador de script. | cuerda |
InstanceViewStatus
Nombre | Descripción | Valor |
---|---|---|
código | Código de estado. | cuerda |
displayStatus | Etiqueta localizable corta para el estado. | cuerda |
nivel | Código de nivel. | 'Error' 'Info' 'Advertencia' |
Mensaje | Mensaje de estado detallado, incluido para alertas y mensajes de error. | cuerda |
Hora | Hora del estado. | cuerda |
KeyVaultSecretReference
Nombre | Descripción | Valor |
---|---|---|
secretUrl | Dirección URL que hace referencia a un secreto en un almacén de claves. | string (obligatorio) |
sourceVault | Dirección URL relativa del almacén de claves que contiene el secreto. | subrecurso |
SubResource
Nombre | Descripción | Valor |
---|---|---|
identificación | Identificador de recurso | cuerda |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla | Descripción |
---|---|
Crear una máquina virtual Windows con la extensión Antimalware habilitada |
Esta plantilla crea una máquina virtual Windows y configura la protección contra malware |
servidor IIS mediante la extensión DSC en una máquina virtual Windows |
Esta plantilla crea una máquina virtual Windows y configura un servidor IIS mediante la extensión DSC. Tenga en cuenta que el módulo de configuración de DSC necesita que se pase un token de SAS si usa Azure Storage. Para el vínculo del módulo DSC desde GitHub (valor predeterminado en esta plantilla), esto no es necesario. |
de extensión de máquina virtual ESET |
Crea una máquina virtual con la extensión ESET. |
McAfee Endpoint Security (licencia de prueba) en máquinas virtuales Windows |
Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de McAfee Endpoint Security |
Implementación de una máquina virtual Ubuntu con la extensión oms |
Esta plantilla le permite implementar una máquina virtual Ubuntu con la extensión oms instalada e incorporada a un área de trabajo especificada. |
Implementación de una máquina virtual Windows con la extensión oms |
Esta plantilla le permite implementar una máquina virtual Windows con la extensión oms instalada e incorporada a un área de trabajo especificada. |
prueba de extensión de Symantec Endpoint Protection en máquinas virtuales Windows |
Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de Symantec Endpoint Protection |
extensión de script personalizado en una máquina virtual Ubuntu |
Esta plantilla crea una máquina virtual Ubuntu e instala la extensión CustomScript. |
extensión de aplicación de revisiones del sistema operativo en una máquina virtual Ubuntu |
Esta plantilla crea una máquina virtual Ubuntu e instala la extensión OSPatching. |
Implementación de una máquina virtual Windows Premium con diagnósticos |
Esta plantilla le permite implementar una máquina virtual Windows Premium con algunas opciones diferentes para la versión de Windows, mediante la versión revisada más reciente. |
Implementación de una máquina virtual Windows sencilla con de supervisión y diagnóstico |
Esta plantilla le permite implementar una máquina virtual Windows sencilla junto con la extensión de diagnóstico que permite la supervisión y el diagnóstico de la máquina virtual. |
Uso de extensiones de script para instalar Mongo DB en máquinas virtuales Ubuntu |
Esta plantilla implementa Configurar e instalar Mongo DB en una máquina virtual Ubuntu en dos scripts independientes. Esta plantilla es un buen ejemplo que muestra cómo expresar dependencias entre dos scripts que se ejecutan en la misma máquina virtual. Esta plantilla también implementa una cuenta de almacenamiento, una red virtual, direcciones IP públicas y una interfaz de red. |
Definición de recursos de plantilla de ARM
El tipo de recurso virtualMachines/extensions se puede implementar con operaciones destinadas a:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Compute/virtualMachines/extensions, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-09-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": {},
"protectedSettingsFromKeyVault": {
"secretUrl": "string",
"sourceVault": {
"id": "string"
}
},
"provisionAfterExtensions": [ "string" ],
"publisher": "string",
"settings": {},
"suppressFailures": "bool",
"type": "string",
"typeHandlerVersion": "string"
}
}
Valores de propiedad
virtualMachines/extensions
Nombre | Descripción | Valor |
---|---|---|
tipo | El tipo de recurso | 'Microsoft.Compute/virtualMachines/extensions' |
apiVersion | La versión de la API de recursos | '2023-09-01' |
nombre | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json. |
string (obligatorio) |
ubicación | Ubicación del recurso | cuerda |
Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
Propiedades | Describe las propiedades de una extensión de máquina virtual. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
Nombre | Descripción | Valor |
---|---|---|
autoUpgradeMinorVersion | Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. | Bool |
enableAutomaticUpgrade | Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. | Bool |
forceUpdateTag | Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. | cuerda |
instanceView | Vista de instancia de extensión de máquina virtual. | virtualMachineExtensionInstanceView |
protectedSettings | La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. | |
protectedSettingsFromKeyVault | Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. | keyVaultSecretReference |
provisionAfterExtensions | Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. | string[] |
editor | Nombre del publicador de controladores de extensión. | cuerda |
Configuración | Configuración pública con formato JSON para la extensión. | |
suppressFailures | Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. | Bool |
tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda |
typeHandlerVersion | Especifica la versión del controlador de script. | cuerda |
VirtualMachineExtensionInstanceView
Nombre | Descripción | Valor |
---|---|---|
nombre | Nombre de la extensión de máquina virtual. | cuerda |
Estados | Información de estado del recurso. | InstanceViewStatus[] |
subestados | Información de estado del recurso. | InstanceViewStatus[] |
tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda |
typeHandlerVersion | Especifica la versión del controlador de script. | cuerda |
InstanceViewStatus
Nombre | Descripción | Valor |
---|---|---|
código | Código de estado. | cuerda |
displayStatus | Etiqueta localizable corta para el estado. | cuerda |
nivel | Código de nivel. | 'Error' 'Info' 'Advertencia' |
Mensaje | Mensaje de estado detallado, incluido para alertas y mensajes de error. | cuerda |
Hora | Hora del estado. | cuerda |
KeyVaultSecretReference
Nombre | Descripción | Valor |
---|---|---|
secretUrl | Dirección URL que hace referencia a un secreto en un almacén de claves. | string (obligatorio) |
sourceVault | Dirección URL relativa del almacén de claves que contiene el secreto. | subrecurso |
SubResource
Nombre | Descripción | Valor |
---|---|---|
identificación | Identificador de recurso | cuerda |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla | Descripción |
---|---|
Crear una máquina virtual Windows con la extensión Antimalware habilitada |
Esta plantilla crea una máquina virtual Windows y configura la protección contra malware |
servidor IIS mediante la extensión DSC en una máquina virtual Windows |
Esta plantilla crea una máquina virtual Windows y configura un servidor IIS mediante la extensión DSC. Tenga en cuenta que el módulo de configuración de DSC necesita que se pase un token de SAS si usa Azure Storage. Para el vínculo del módulo DSC desde GitHub (valor predeterminado en esta plantilla), esto no es necesario. |
de extensión de máquina virtual ESET |
Crea una máquina virtual con la extensión ESET. |
McAfee Endpoint Security (licencia de prueba) en máquinas virtuales Windows |
Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de McAfee Endpoint Security |
Implementación de una máquina virtual Ubuntu con la extensión oms |
Esta plantilla le permite implementar una máquina virtual Ubuntu con la extensión oms instalada e incorporada a un área de trabajo especificada. |
Implementación de una máquina virtual Windows con la extensión oms |
Esta plantilla le permite implementar una máquina virtual Windows con la extensión oms instalada e incorporada a un área de trabajo especificada. |
prueba de extensión de Symantec Endpoint Protection en máquinas virtuales Windows |
Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de Symantec Endpoint Protection |
extensión de script personalizado en una máquina virtual Ubuntu |
Esta plantilla crea una máquina virtual Ubuntu e instala la extensión CustomScript. |
extensión de aplicación de revisiones del sistema operativo en una máquina virtual Ubuntu |
Esta plantilla crea una máquina virtual Ubuntu e instala la extensión OSPatching. |
Implementación de una máquina virtual Windows Premium con diagnósticos |
Esta plantilla le permite implementar una máquina virtual Windows Premium con algunas opciones diferentes para la versión de Windows, mediante la versión revisada más reciente. |
Implementación de una máquina virtual Windows sencilla con de supervisión y diagnóstico |
Esta plantilla le permite implementar una máquina virtual Windows sencilla junto con la extensión de diagnóstico que permite la supervisión y el diagnóstico de la máquina virtual. |
Uso de extensiones de script para instalar Mongo DB en máquinas virtuales Ubuntu |
Esta plantilla implementa Configurar e instalar Mongo DB en una máquina virtual Ubuntu en dos scripts independientes. Esta plantilla es un buen ejemplo que muestra cómo expresar dependencias entre dos scripts que se ejecutan en la misma máquina virtual. Esta plantilla también implementa una cuenta de almacenamiento, una red virtual, direcciones IP públicas y una interfaz de red. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso virtualMachines/extensions se puede implementar con operaciones destinadas a:
- grupos de recursos de
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Compute/virtualMachines/extensions, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/virtualMachines/extensions@2023-09-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"
}
protectedSettingsFromKeyVault = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
provisionAfterExtensions = [
"string"
]
publisher = "string"
suppressFailures = bool
type = "string"
typeHandlerVersion = "string"
}
})
}
Valores de propiedad
virtualMachines/extensions
Nombre | Descripción | Valor |
---|---|---|
tipo | El tipo de recurso | "Microsoft.Compute/virtualMachines/extensions@2023-09-01" |
nombre | El nombre del recurso | string (obligatorio) |
ubicación | Ubicación del recurso | cuerda |
parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: virtualMachines |
Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. |
Propiedades | Describe las propiedades de una extensión de máquina virtual. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
Nombre | Descripción | Valor |
---|---|---|
autoUpgradeMinorVersion | Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. | Bool |
enableAutomaticUpgrade | Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. | Bool |
forceUpdateTag | Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. | cuerda |
instanceView | Vista de instancia de extensión de máquina virtual. | virtualMachineExtensionInstanceView |
protectedSettings | La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. | |
protectedSettingsFromKeyVault | Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. | keyVaultSecretReference |
provisionAfterExtensions | Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. | string[] |
editor | Nombre del publicador de controladores de extensión. | cuerda |
Configuración | Configuración pública con formato JSON para la extensión. | |
suppressFailures | Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. | Bool |
tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda |
typeHandlerVersion | Especifica la versión del controlador de script. | cuerda |
VirtualMachineExtensionInstanceView
Nombre | Descripción | Valor |
---|---|---|
nombre | Nombre de la extensión de máquina virtual. | cuerda |
Estados | Información de estado del recurso. | InstanceViewStatus[] |
subestados | Información de estado del recurso. | InstanceViewStatus[] |
tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda |
typeHandlerVersion | Especifica la versión del controlador de script. | cuerda |
InstanceViewStatus
Nombre | Descripción | Valor |
---|---|---|
código | Código de estado. | cuerda |
displayStatus | Etiqueta localizable corta para el estado. | cuerda |
nivel | Código de nivel. | "Error" "Información" "Advertencia" |
Mensaje | Mensaje de estado detallado, incluido para alertas y mensajes de error. | cuerda |
Hora | Hora del estado. | cuerda |
KeyVaultSecretReference
Nombre | Descripción | Valor |
---|---|---|
secretUrl | Dirección URL que hace referencia a un secreto en un almacén de claves. | string (obligatorio) |
sourceVault | Dirección URL relativa del almacén de claves que contiene el secreto. | subrecurso |
SubResource
Nombre | Descripción | Valor |
---|---|---|
identificación | Identificador de recurso | cuerda |