VirtualMachineRunCommand Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
VirtualMachineRunCommand.
public class VirtualMachineRunCommand : Azure.Provisioning.Primitives.ProvisionableResource
type VirtualMachineRunCommand = class
inherit ProvisionableResource
Public Class VirtualMachineRunCommand
Inherits ProvisionableResource
- Inheritance
-
VirtualMachineRunCommand
Constructors
| Name | Description |
|---|---|
| VirtualMachineRunCommand(String, String) |
Creates a new VirtualMachineRunCommand. |
Properties
| Name | Description |
|---|---|
| AsyncExecution |
Optional. If set to true, provisioning will complete as soon as the script starts and will not wait for script to complete. |
| BicepIdentifier |
Gets or sets the the Bicep identifier name of the resource. This can be used to refer to the resource in expressions, but is not the Azure name of the resource. This value can contain letters, numbers, and underscores. (Inherited from NamedProvisionableConstruct) |
| BicepMetadata |
Gets the Bicep metadata for this resource, including decorators and conditions. (Inherited from ProvisionableResource) |
| DependsOn |
Declares explicit dependencies on other resources. (Inherited from ProvisionableResource) |
| ErrorBlobManagedIdentity |
User-assigned managed identity that has access to errorBlobUri storage blob. Use an empty object in case of system-assigned identity. Make sure managed identity has been given access to blob's container with 'Storage Blob Data Contributor' role assignment. In case of user-assigned identity, make sure you add it under VM's identity. For more info on managed identity and Run Command, refer https://aka.ms/ManagedIdentity and https://aka.ms/RunCommandManaged. |
| ErrorBlobUri |
Specifies the Azure storage blob where script error stream will be uploaded. Use a SAS URI with read, append, create, write access OR use managed identity to provide the VM access to the blob. Refer errorBlobManagedIdentity parameter. |
| Id |
Gets the Id. |
| InstanceView |
The virtual machine run command instance view. |
| IsExistingResource |
Gets whether this is referencing an existing resource or we're defining a new resource. (Inherited from ProvisionableResource) |
| Location |
Gets or sets the Location. |
| Name |
The name of the VirtualMachineRunCommand. |
| OutputBlobManagedIdentity |
User-assigned managed identity that has access to outputBlobUri storage blob. Use an empty object in case of system-assigned identity. Make sure managed identity has been given access to blob's container with 'Storage Blob Data Contributor' role assignment. In case of user-assigned identity, make sure you add it under VM's identity. For more info on managed identity and Run Command, refer https://aka.ms/ManagedIdentity and https://aka.ms/RunCommandManaged. |
| OutputBlobUri |
Specifies the Azure storage blob where script output stream will be uploaded. Use a SAS URI with read, append, create, write access OR use managed identity to provide the VM access to the blob. Refer outputBlobManagedIdentity parameter. |
| Parameters |
The parameters used by the script. |
| Parent |
Gets or sets a reference to the parent VirtualMachine. |
| ProtectedParameters |
The parameters used by the script. |
| ProvisioningState |
The provisioning state, which only appears in the response. If treatFailureAsDeploymentFailure set to true, any failure in the script will fail the deployment and ProvisioningState will be marked as Failed. If treatFailureAsDeploymentFailure set to false, ProvisioningState would only reflect whether the run command was run or not by the extensions platform, it would not indicate whether script failed in case of script failures. See instance view of run command in case of script failures to see executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results. |
| ResourceType |
Gets the type of the resource. (Inherited from ProvisionableResource) |
| ResourceVersion |
Gets or sets the version of the resource. (Inherited from ProvisionableResource) |
| RunAsPassword |
Specifies the user account password on the VM when executing the run command. |
| RunAsUser |
Specifies the user account on the VM when executing the run command. |
| Source |
The source of the run command script. |
| SystemData |
Gets the SystemData. |
| Tags |
Gets or sets the Tags. |
| TimeoutInSeconds |
The timeout in seconds to execute the run command. |
| TreatFailureAsDeploymentFailure |
Optional. If set to true, any failure in the script will fail the deployment and ProvisioningState will be marked as Failed. If set to false, ProvisioningState would only reflect whether the run command was run or not by the extensions platform, it would not indicate whether script failed in case of script failures. See instance view of run command in case of script failures to see executionMessage, output, error: https://aka.ms/runcommandmanaged#get-execution-status-and-results. |
Methods
Explicit Interface Implementations
| Name | Description |
|---|---|
| IBicepValue.Assign(IBicepValue) |
Assign a value to this property. (Inherited from ProvisionableConstruct) |
| IBicepValue.Compile() |
Compile this value to a Bicep expression. (Inherited from ProvisionableConstruct) |
| IBicepValue.Expression |
Gets the expression for this value if it's not a literal. (Inherited from ProvisionableConstruct) |
| IBicepValue.IsEmpty |
Gets whether this value is unset or empty. (Inherited from ProvisionableConstruct) |
| IBicepValue.IsOutput |
Tracks whether this is an output only property. (Inherited from ProvisionableConstruct) |
| IBicepValue.IsRequired |
Tracks whether this property is required. (Inherited from ProvisionableConstruct) |
| IBicepValue.IsSecure |
Tracks whether this contains a secure value. (Inherited from ProvisionableConstruct) |
| IBicepValue.Kind |
Gets the kind of this value (a literal value, an expression, or it's unset). (Inherited from ProvisionableConstruct) |
| IBicepValue.LiteralValue |
Get the value of this expression, if it's literal. (Inherited from ProvisionableConstruct) |
| IBicepValue.Self |
Gets information about where this value was defined. (Inherited from ProvisionableConstruct) |
| IBicepValue.SetReadOnly() |
Make this value readonly. (Inherited from ProvisionableConstruct) |
| IBicepValue.Source |
Gets information about where this value was assigned from. (Inherited from ProvisionableConstruct) |
Extension Methods
| Name | Description |
|---|---|
| ToBicepExpression(IBicepValue) |
Convert a IBicepValue into a BicepExpression by its reference to represent its hierarchy. |