다음을 통해 공유

VirtualMachineRunCommand 클래스

  • 참조

Virtual Machine 실행 명령에 대해 설명합니다.

변수는 서버에서만 채워지고 요청을 보낼 때 무시됩니다.

Azure로 보내려면 모든 필수 매개 변수를 채워야 합니다.

상속
azure.mgmt.compute.v2023_07_01.models._models_py3.Resource
VirtualMachineRunCommand

생성자

VirtualMachineRunCommand(*, location: str, tags: Dict[str, str] | None = None, source: _models.VirtualMachineRunCommandScriptSource | None = None, parameters: List[_models.RunCommandInputParameter] | None = None, protected_parameters: List[_models.RunCommandInputParameter] | None = None, async_execution: bool = False, run_as_user: str | None = None, run_as_password: str | None = None, timeout_in_seconds: int | None = None, output_blob_uri: str | None = None, error_blob_uri: str | None = None, output_blob_managed_identity: _models.RunCommandManagedIdentity | None = None, error_blob_managed_identity: _models.RunCommandManagedIdentity | None = None, treat_failure_as_deployment_failure: bool = False, **kwargs: Any)

Keyword-Only Parameters

location
str

리소스 위치. 필수 사항입니다.

tags
dict[str, str]

리소스 태그.

source
VirtualMachineRunCommandScriptSource

실행 명령 스크립트의 원본입니다.

parameters
list[RunCommandInputParameter]

스크립트에서 사용하는 매개 변수입니다.

protected_parameters
list[RunCommandInputParameter]

스크립트에서 사용하는 매개 변수입니다.

async_execution
bool

선택 사항입니다. true로 설정하면 스크립트가 시작되는 즉시 프로비전이 완료되고 스크립트가 완료될 때까지 기다리지 않습니다.

run_as_user
str

실행 명령을 실행할 때 VM의 사용자 계정을 지정합니다.

run_as_password
str

실행 명령을 실행할 때 VM의 사용자 계정 암호를 지정합니다.

timeout_in_seconds
int

실행 명령을 실행할 시간 제한(초)입니다.

output_blob_uri
str

스크립트 출력 스트림이 업로드될 Azure Storage Blob을 지정합니다. 읽기, 추가, 만들기, 쓰기 액세스가 있는 SAS URI를 사용하거나 관리 ID를 사용하여 Blob에 대한 VM 액세스를 제공합니다. outputBlobManagedIdentity 매개 변수를 참조하세요.

error_blob_uri
str

스크립트 오류 스트림이 업로드될 Azure Storage Blob을 지정합니다. 읽기, 추가, 만들기, 쓰기 액세스가 있는 SAS URI를 사용하거나 관리 ID를 사용하여 Blob에 대한 VM 액세스를 제공합니다. errorBlobManagedIdentity 매개 변수를 참조하세요.

output_blob_managed_identity
RunCommandManagedIdentity

outputBlobUri 스토리지 Blob에 대한 액세스 권한이 있는 사용자 할당 관리 ID입니다. 시스템 할당 ID의 경우 빈 개체를 사용합니다. 관리 ID에 'Storage Blob 데이터 기여자' 역할 할당을 사용하여 Blob의 컨테이너에 대한 액세스 권한이 부여되었는지 확인합니다. 사용자 할당 ID의 경우 VM의 ID 아래에 추가해야 합니다. 관리 ID 및 실행 명령에 대한 자세한 내용은 및 https://aka.ms/RunCommandManaged를 참조하세요https://aka.ms/ManagedIdentity.

error_blob_managed_identity
RunCommandManagedIdentity

errorBlobUri 스토리지 Blob에 대한 액세스 권한이 있는 사용자 할당 관리 ID입니다. 시스템 할당 ID의 경우 빈 개체를 사용합니다. 관리 ID에 'Storage Blob 데이터 기여자' 역할 할당을 사용하여 Blob의 컨테이너에 대한 액세스 권한이 부여되었는지 확인합니다. 사용자 할당 ID의 경우 VM의 ID 아래에 추가해야 합니다. 관리 ID 및 실행 명령에 대한 자세한 내용은 및 https://aka.ms/RunCommandManaged를 참조하세요https://aka.ms/ManagedIdentity.

treat_failure_as_deployment_failure
bool

선택 사항입니다. true로 설정하면 스크립트의 오류가 배포에 실패하고 ProvisioningState가 실패로 표시됩니다. false로 설정된 경우 ProvisioningState는 실행 명령이 확장 플랫폼에서 실행되었는지 여부만 반영하며 스크립트 오류가 발생하는 경우 스크립트가 실패했는지 여부를 나타내지 않습니다. 스크립트 실패 시 실행 명령의 instance 보기를 참조하여 executionMessage, output, error를 https://aka.ms/runcommandmanaged#get-execution-status-and-results확인합니다.

변수

id
str

리소스 ID입니다.

name
str

리소스 이름입니다.

type
str

리소스 종류.

location
str

리소스 위치. 필수 사항입니다.

tags
dict[str, str]

리소스 태그.

source
VirtualMachineRunCommandScriptSource

실행 명령 스크립트의 원본입니다.

parameters
list[RunCommandInputParameter]

스크립트에서 사용하는 매개 변수입니다.

protected_parameters
list[RunCommandInputParameter]

스크립트에서 사용하는 매개 변수입니다.

async_execution
bool

선택 사항입니다. true로 설정하면 스크립트가 시작되는 즉시 프로비전이 완료되고 스크립트가 완료될 때까지 기다리지 않습니다.

run_as_user
str

실행 명령을 실행할 때 VM의 사용자 계정을 지정합니다.

run_as_password
str

실행 명령을 실행할 때 VM의 사용자 계정 암호를 지정합니다.

timeout_in_seconds
int

실행 명령을 실행할 시간 제한(초)입니다.

output_blob_uri
str

스크립트 출력 스트림이 업로드될 Azure Storage Blob을 지정합니다. 읽기, 추가, 만들기, 쓰기 액세스가 있는 SAS URI를 사용하거나 관리 ID를 사용하여 Blob에 대한 VM 액세스를 제공합니다. outputBlobManagedIdentity 매개 변수를 참조하세요.

error_blob_uri
str

스크립트 오류 스트림이 업로드될 Azure Storage Blob을 지정합니다. 읽기, 추가, 만들기, 쓰기 액세스가 있는 SAS URI를 사용하거나 관리 ID를 사용하여 Blob에 대한 VM 액세스를 제공합니다. errorBlobManagedIdentity 매개 변수를 참조하세요.

output_blob_managed_identity
RunCommandManagedIdentity

outputBlobUri 스토리지 Blob에 대한 액세스 권한이 있는 사용자 할당 관리 ID입니다. 시스템 할당 ID의 경우 빈 개체를 사용합니다. 관리 ID에 'Storage Blob 데이터 기여자' 역할 할당을 사용하여 Blob의 컨테이너에 대한 액세스 권한이 부여되었는지 확인합니다. 사용자 할당 ID의 경우 VM의 ID 아래에 추가해야 합니다. 관리 ID 및 실행 명령에 대한 자세한 내용은 및 https://aka.ms/RunCommandManaged를 참조하세요https://aka.ms/ManagedIdentity.

error_blob_managed_identity
RunCommandManagedIdentity

errorBlobUri 스토리지 Blob에 대한 액세스 권한이 있는 사용자 할당 관리 ID입니다. 시스템 할당 ID의 경우 빈 개체를 사용합니다. 관리 ID에 'Storage Blob 데이터 기여자' 역할 할당을 사용하여 Blob의 컨테이너에 대한 액세스 권한이 부여되었는지 확인합니다. 사용자 할당 ID의 경우 VM의 ID 아래에 추가해야 합니다. 관리 ID 및 실행 명령에 대한 자세한 내용은 및 https://aka.ms/RunCommandManaged를 참조하세요https://aka.ms/ManagedIdentity.

provisioning_state
str

응답에만 표시되는 프로비전 상태입니다. treatFailureAsDeploymentFailure가 true로 설정되면 스크립트의 모든 오류가 배포에 실패하고 ProvisioningState가 실패로 표시됩니다. treatFailureAsDeploymentFailure가 false로 설정된 경우 ProvisioningState는 확장 플랫폼에서 실행 명령이 실행되었는지 여부만 반영합니다. 스크립트 실패 시 스크립트가 실패했는지 여부는 나타내지 않습니다. 스크립트 실패 시 실행 명령의 instance 보기를 참조하여 executionMessage, output, error를 https://aka.ms/runcommandmanaged#get-execution-status-and-results확인합니다.

instance_view
VirtualMachineRunCommandInstanceView

가상 머신 실행 명령 instance 보기입니다.

treat_failure_as_deployment_failure
bool

선택 사항입니다. true로 설정하면 스크립트의 오류가 배포에 실패하고 ProvisioningState가 실패로 표시됩니다. false로 설정된 경우 ProvisioningState는 실행 명령이 확장 플랫폼에서 실행되었는지 여부만 반영하며 스크립트 오류가 발생하는 경우 스크립트가 실패했는지 여부를 나타내지 않습니다. 스크립트 실패 시 실행 명령의 instance 보기를 참조하여 executionMessage, output, error를 https://aka.ms/runcommandmanaged#get-execution-status-and-results확인합니다.