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.
Describe las propiedades de un comando de ejecución de máquina virtual.
VirtualMachineRunCommandProperties
Etiquetas
Etiquetas de recursos
Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
ResourceTags
Nombre
Descripción
Valor
RunCommandInputParameter
Nombre
Descripción
Valor
nombre
Nombre del parámetro del comando run.
string (obligatorio)
valor
Valor del parámetro del comando run.
string (obligatorio)
RunCommandManagedIdentity
Nombre
Descripción
Valor
clientId
Id. de cliente (valor GUID) de la identidad administrada asignada por el usuario. ObjectId no se debe usar si se proporciona.
cuerda
objectId
Id. de objeto (valor GUID) de la identidad administrada asignada por el usuario. ClientId no debe usarse si se proporciona.
cuerda
VirtualMachineRunCommandProperties
Nombre
Descripción
Valor
asyncExecution
Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.
Bool
errorBlobManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento errorBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged
RunCommandManagedIdentity
errorBlobUri
Especifica el blob de Azure Storage donde se cargará el flujo de error del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro errorBlobManagedIdentity.
cuerda
outputBlobManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento outputBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged
RunCommandManagedIdentity
outputBlobUri
Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro outputBlobManagedIdentity.
cuerda
Parámetros
Parámetros usados por el script.
runCommandInputParameter []
protectedParameters
Parámetros usados por el script.
runCommandInputParameter []
runAsPassword
Especifica la contraseña de la cuenta de usuario en la máquina virtual al ejecutar el comando run.
cuerda
runAsUser
Especifica la cuenta de usuario en la máquina virtual al ejecutar el comando run.
Tiempo de espera en segundos para ejecutar el comando run.
Int
treatFailureAsDeploymentFailure
Opcional. Si se establece en true, cualquier error en el script producirá un error en la implementación y ProvisioningState se marcará como Error. Si se establece en false, ProvisioningState solo reflejaría si la plataforma de extensiones ejecutó o no el comando de ejecución, no indicaría si se produjo un error en el script en caso de errores de script. Consulte la vista de instancia del comando run en caso de errores de script para ver executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results
Bool
VirtualMachineRunCommandScriptSource
Nombre
Descripción
Valor
commandId
Especifica un commandId de script integrado predefinido.
cuerda
Guión
Especifica el contenido del script que se va a ejecutar en la máquina virtual.
cuerda
scriptUri
Especifica la ubicación de descarga del script. Puede ser un URI de SAS de un blob de Azure Storage con acceso de lectura o URI público.
cuerda
scriptUriManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso a scriptUri en caso de blob de Azure Storage. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que existe el blob de Azure Storage y de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Lector de datos de blobs de almacenamiento". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged.
RunCommandManagedIdentity
Ejemplos de inicio rápido
En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.
Archivo de Bicep
Descripción
de GitLab Oops
Esta plantilla simplifica la implementación de GitLab Oops en una máquina virtual con un DNS público, aprovechando el DNS de la dirección IP pública. Utiliza el tamaño de instancia de Standard_F8s_v2, que se alinea con la arquitectura de referencia y admite hasta 1000 usuarios (20 RPS). La instancia está preconfigurada para usar HTTPS con un certificado Let's Encrypt para conexiones seguras.
Cree un controlador de dominio, una granja de SQL Server 2022 y de 1 a 5 servidores que hospedan una suscripción de SharePoint / 2019 / 2016 con una amplia configuración, incluida la autenticación de confianza, perfiles de usuario con sitios personales, una confianza de OAuth (mediante un certificado), un sitio IIS dedicado para hospedar complementos de elevada confianza, etc... Se instala la versión más reciente de los softwares clave (incluido Fiddler, vscode, np++, 7zip, ULS Viewer). Las máquinas de SharePoint tienen un ajuste adicional para que se puedan usar inmediatamente (herramientas de administración remota, directivas personalizadas para Edge y Chrome, accesos directos, etc.).
Definición de recursos de plantilla de ARM
El tipo de recurso virtualMachines/runCommands se puede implementar con las operaciones que tienen como destino:
Describe las propiedades de un comando de ejecución de máquina virtual.
VirtualMachineRunCommandProperties
Etiquetas
Etiquetas de recursos
Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo
El tipo de recurso
'Microsoft.Compute/virtualMachines/runCommands'
ResourceTags
Nombre
Descripción
Valor
RunCommandInputParameter
Nombre
Descripción
Valor
nombre
Nombre del parámetro del comando run.
string (obligatorio)
valor
Valor del parámetro del comando run.
string (obligatorio)
RunCommandManagedIdentity
Nombre
Descripción
Valor
clientId
Id. de cliente (valor GUID) de la identidad administrada asignada por el usuario. ObjectId no se debe usar si se proporciona.
cuerda
objectId
Id. de objeto (valor GUID) de la identidad administrada asignada por el usuario. ClientId no debe usarse si se proporciona.
cuerda
VirtualMachineRunCommandProperties
Nombre
Descripción
Valor
asyncExecution
Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.
Bool
errorBlobManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento errorBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged
RunCommandManagedIdentity
errorBlobUri
Especifica el blob de Azure Storage donde se cargará el flujo de error del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro errorBlobManagedIdentity.
cuerda
outputBlobManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento outputBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged
RunCommandManagedIdentity
outputBlobUri
Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro outputBlobManagedIdentity.
cuerda
Parámetros
Parámetros usados por el script.
runCommandInputParameter []
protectedParameters
Parámetros usados por el script.
runCommandInputParameter []
runAsPassword
Especifica la contraseña de la cuenta de usuario en la máquina virtual al ejecutar el comando run.
cuerda
runAsUser
Especifica la cuenta de usuario en la máquina virtual al ejecutar el comando run.
Tiempo de espera en segundos para ejecutar el comando run.
Int
treatFailureAsDeploymentFailure
Opcional. Si se establece en true, cualquier error en el script producirá un error en la implementación y ProvisioningState se marcará como Error. Si se establece en false, ProvisioningState solo reflejaría si la plataforma de extensiones ejecutó o no el comando de ejecución, no indicaría si se produjo un error en el script en caso de errores de script. Consulte la vista de instancia del comando run en caso de errores de script para ver executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results
Bool
VirtualMachineRunCommandScriptSource
Nombre
Descripción
Valor
commandId
Especifica un commandId de script integrado predefinido.
cuerda
Guión
Especifica el contenido del script que se va a ejecutar en la máquina virtual.
cuerda
scriptUri
Especifica la ubicación de descarga del script. Puede ser un URI de SAS de un blob de Azure Storage con acceso de lectura o URI público.
cuerda
scriptUriManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso a scriptUri en caso de blob de Azure Storage. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que existe el blob de Azure Storage y de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Lector de datos de blobs de almacenamiento". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged.
RunCommandManagedIdentity
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla
Descripción
de GitLab Oops
Esta plantilla simplifica la implementación de GitLab Oops en una máquina virtual con un DNS público, aprovechando el DNS de la dirección IP pública. Utiliza el tamaño de instancia de Standard_F8s_v2, que se alinea con la arquitectura de referencia y admite hasta 1000 usuarios (20 RPS). La instancia está preconfigurada para usar HTTPS con un certificado Let's Encrypt para conexiones seguras.
Cree un controlador de dominio, una granja de SQL Server 2022 y de 1 a 5 servidores que hospedan una suscripción de SharePoint / 2019 / 2016 con una amplia configuración, incluida la autenticación de confianza, perfiles de usuario con sitios personales, una confianza de OAuth (mediante un certificado), un sitio IIS dedicado para hospedar complementos de elevada confianza, etc... Se instala la versión más reciente de los softwares clave (incluido Fiddler, vscode, np++, 7zip, ULS Viewer). Las máquinas de SharePoint tienen un ajuste adicional para que se puedan usar inmediatamente (herramientas de administración remota, directivas personalizadas para Edge y Chrome, accesos directos, etc.).
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso virtualMachines/runCommands se puede implementar con las operaciones que tienen como destino:
Grupo 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/runCommands, agregue el siguiente terraform a la plantilla.
Id. de cliente (valor GUID) de la identidad administrada asignada por el usuario. ObjectId no se debe usar si se proporciona.
cuerda
objectId
Id. de objeto (valor GUID) de la identidad administrada asignada por el usuario. ClientId no debe usarse si se proporciona.
cuerda
VirtualMachineRunCommandProperties
Nombre
Descripción
Valor
asyncExecution
Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.
Bool
errorBlobManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento errorBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged
RunCommandManagedIdentity
errorBlobUri
Especifica el blob de Azure Storage donde se cargará el flujo de error del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro errorBlobManagedIdentity.
cuerda
outputBlobManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso al blob de almacenamiento outputBlobUri. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Colaborador de datos de storage Blob". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged
RunCommandManagedIdentity
outputBlobUri
Especifica el blob de Azure Storage donde se cargará el flujo de salida del script. Use un URI de SAS con lectura, anexión, creación, creación, acceso de escritura O use la identidad administrada para proporcionar a la máquina virtual acceso al blob. Consulte el parámetro outputBlobManagedIdentity.
cuerda
Parámetros
Parámetros usados por el script.
runCommandInputParameter []
protectedParameters
Parámetros usados por el script.
runCommandInputParameter []
runAsPassword
Especifica la contraseña de la cuenta de usuario en la máquina virtual al ejecutar el comando run.
cuerda
runAsUser
Especifica la cuenta de usuario en la máquina virtual al ejecutar el comando run.
Tiempo de espera en segundos para ejecutar el comando run.
Int
treatFailureAsDeploymentFailure
Opcional. Si se establece en true, cualquier error en el script producirá un error en la implementación y ProvisioningState se marcará como Error. Si se establece en false, ProvisioningState solo reflejaría si la plataforma de extensiones ejecutó o no el comando de ejecución, no indicaría si se produjo un error en el script en caso de errores de script. Consulte la vista de instancia del comando run en caso de errores de script para ver executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results
Bool
VirtualMachineRunCommandScriptSource
Nombre
Descripción
Valor
commandId
Especifica un commandId de script integrado predefinido.
cuerda
Guión
Especifica el contenido del script que se va a ejecutar en la máquina virtual.
cuerda
scriptUri
Especifica la ubicación de descarga del script. Puede ser un URI de SAS de un blob de Azure Storage con acceso de lectura o URI público.
cuerda
scriptUriManagedIdentity
Identidad administrada asignada por el usuario que tiene acceso a scriptUri en caso de blob de Azure Storage. Use un objeto vacío en caso de identidad asignada por el sistema. Asegúrese de que existe el blob de Azure Storage y de que se ha concedido acceso a la identidad administrada al contenedor del blob con la asignación de roles "Lector de datos de blobs de almacenamiento". En el caso de la identidad asignada por el usuario, asegúrese de agregarla en la identidad de la máquina virtual. Para obtener más información sobre la identidad administrada y ejecutar comando, consulte https://aka.ms/ManagedIdentity y https://aka.ms/RunCommandManaged.