Microsoft.HybridCompute makineleri/runCommands 2025-02-19-preview

2025-06-24

Bicep kaynak tanımı

Makineler/runCommands kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.HybridCompute/machines/runCommands kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.HybridCompute/machines/runCommands@2025-02-19-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    asyncExecution: bool
    errorBlobManagedIdentity: {
      clientId: 'string'
      objectId: 'string'
    }
    errorBlobUri: 'string'
    outputBlobManagedIdentity: {
      clientId: 'string'
      objectId: 'string'
    }
    outputBlobUri: 'string'
    parameters: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    protectedParameters: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    runAsPassword: 'string'
    runAsUser: 'string'
    source: {
      commandId: 'string'
      script: 'string'
      scriptUri: 'string'
      scriptUriManagedIdentity: {
        clientId: 'string'
        objectId: 'string'
      }
    }
    timeoutInSeconds: int
  }
  tags: {
    {customized property}: 'string'
  }
}

Özellik Değerleri

Microsoft.HybridCompute/machines/runCommands

İsim	Açıklama	Değer
konum	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
isim	Kaynak adı	karakter dizisi Kısıtlama -ları: Desen = `[a-zA-Z0-9-_\.]+` (gerekli)
veli	Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir. Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.	Kaynak türü için sembolik ad: makineler
özellikler	Çalıştırma Komutu Özelliklerini Açıklar	MachineRunCommandProperties
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

MachineRunCommandProperties

İsim	Açıklama	Değer
asyncExecution	Opsiyonel. True olarak ayarlanırsa, sağlama işlemi betik başlar başlamaz tamamlanır ve betiğin tamamlanmasını beklemez.	Boole
errorBlobManagedIdentity	errorBlobUri depolama blob'una erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Yönetilen kimliğe 'Depolama Blob Verileri Katkıda Bulunanı' rol ataması ile blob kapsayıcısına erişim verildiğine emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged	RunCommandManagedIdentity
errorBlobUri	Betik hata akışının karşıya yüklendiği Azure depolama blobunu belirtir. Okuma, ekleme, oluşturma, yazma erişimi olan bir SAS URI'sini kullanın VEYA bloba VM erişimi sağlamak için yönetilen kimliği kullanın. ErrorBlobManagedIdentity parametresine bakın.	String
outputBlobManagedIdentity	outputBlobUri depolama blob'una erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Yönetilen kimliğe 'Depolama Blob Verileri Katkıda Bulunanı' rol ataması ile blob kapsayıcısına erişim verildiğine emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged	RunCommandManagedIdentity
outputBlobUri	Betik çıktı akışının karşıya yüklendiği Azure depolama blobunu belirtir. Okuma, ekleme, oluşturma, yazma erişimi olan bir SAS URI'sini kullanın VEYA bloba VM erişimi sağlamak için yönetilen kimliği kullanın. outputBlobManagedIdentity parametresine bakın.	String
Parametreler	Betik tarafından kullanılan parametreler.	RunCommandInputParameter[]
protectedParameters	Betik tarafından kullanılan parametreler.	RunCommandInputParameter[]
runAsPassword	Çalıştır komutunu yürütürken makinedeki kullanıcı hesabı parolasını belirtir.	karakter dizisi Kısıtlama -ları: Hassas değer. Güvenli parametre olarak geçirin.
runAsUser	Run komutunu yürütürken makinedeki kullanıcı hesabını belirtir.	String
kaynak	Çalıştırma komut betiğinin kaynağı.	MachineRunCommandScriptSource
timeoutInSeconds	Çalıştırma komutunu yürütmek için saniyeler içinde zaman aşımı.	Int

MachineRunCommandScriptSource

İsim	Açıklama	Değer
komut Kimliği	Önceden tanımlanmış yerleşik betiğin commandId değerini belirtir.	String
komut dosyası	Makinede yürütülecek betik içeriğini belirtir.	String
scriptUri	Betik indirme konumunu belirtir. Okuma erişimi olan bir Azure depolama blobunun SAS URI'si veya genel URI olabilir.	String
scriptUriManagedIdentity	Azure depolama blobu durumunda scriptUri'ye erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Azure depolama blobunun mevcut olduğundan ve yönetilen kimliğe 'Depolama Blobu Veri Okuyucusu' rol ataması ile blob kapsayıcısına erişim verildiğinden emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged.	RunCommandManagedIdentity

RunCommandInputParameter

İsim	Açıklama	Değer
isim	Komut parametresi adını çalıştırın.	dize (gerekli)
değer	Komut parametresini çalıştırma değeri.	dize (gerekli)

RunCommandManagedIdentity

İsim	Açıklama	Değer
clientId (İstemci Kimliği)	Kullanıcı tarafından atanan yönetilen kimliğin İstemci Kimliği (GUID değeri). Bu sağlanırsa ObjectId kullanılmamalıdır.	String
objectId (nesne kimliği)	Kullanıcı tarafından atanan yönetilen kimliğin Nesne Kimliği (GUID değeri). Bu sağlanırsa ClientId kullanılmamalıdır.	String

TrackedResourceTags

İsim	Açıklama	Değer

ARM şablonu kaynak tanımı

Makineler/runCommands kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.HybridCompute/machines/runCommands kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.HybridCompute/machines/runCommands",
  "apiVersion": "2025-02-19-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "asyncExecution": "bool",
    "errorBlobManagedIdentity": {
      "clientId": "string",
      "objectId": "string"
    },
    "errorBlobUri": "string",
    "outputBlobManagedIdentity": {
      "clientId": "string",
      "objectId": "string"
    },
    "outputBlobUri": "string",
    "parameters": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "protectedParameters": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "runAsPassword": "string",
    "runAsUser": "string",
    "source": {
      "commandId": "string",
      "script": "string",
      "scriptUri": "string",
      "scriptUriManagedIdentity": {
        "clientId": "string",
        "objectId": "string"
      }
    },
    "timeoutInSeconds": "int"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Özellik Değerleri

Microsoft.HybridCompute/machines/runCommands

İsim	Açıklama	Değer
apiVersiyonu	API sürümü	'2025-02-19-önizleme'
konum	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
isim	Kaynak adı	karakter dizisi Kısıtlama -ları: Desen = `[a-zA-Z0-9-_\.]+` (gerekli)
özellikler	Çalıştırma Komutu Özelliklerini Açıklar	MachineRunCommandProperties
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
tür	Kaynak türü	'Microsoft.HybridCompute/machines/runCommands'

MachineRunCommandProperties

İsim	Açıklama	Değer
asyncExecution	Opsiyonel. True olarak ayarlanırsa, sağlama işlemi betik başlar başlamaz tamamlanır ve betiğin tamamlanmasını beklemez.	Boole
errorBlobManagedIdentity	errorBlobUri depolama blob'una erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Yönetilen kimliğe 'Depolama Blob Verileri Katkıda Bulunanı' rol ataması ile blob kapsayıcısına erişim verildiğine emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged	RunCommandManagedIdentity
errorBlobUri	Betik hata akışının karşıya yüklendiği Azure depolama blobunu belirtir. Okuma, ekleme, oluşturma, yazma erişimi olan bir SAS URI'sini kullanın VEYA bloba VM erişimi sağlamak için yönetilen kimliği kullanın. ErrorBlobManagedIdentity parametresine bakın.	String
outputBlobManagedIdentity	outputBlobUri depolama blob'una erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Yönetilen kimliğe 'Depolama Blob Verileri Katkıda Bulunanı' rol ataması ile blob kapsayıcısına erişim verildiğine emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged	RunCommandManagedIdentity
outputBlobUri	Betik çıktı akışının karşıya yüklendiği Azure depolama blobunu belirtir. Okuma, ekleme, oluşturma, yazma erişimi olan bir SAS URI'sini kullanın VEYA bloba VM erişimi sağlamak için yönetilen kimliği kullanın. outputBlobManagedIdentity parametresine bakın.	String
Parametreler	Betik tarafından kullanılan parametreler.	RunCommandInputParameter[]
protectedParameters	Betik tarafından kullanılan parametreler.	RunCommandInputParameter[]
runAsPassword	Çalıştır komutunu yürütürken makinedeki kullanıcı hesabı parolasını belirtir.	karakter dizisi Kısıtlama -ları: Hassas değer. Güvenli parametre olarak geçirin.
runAsUser	Run komutunu yürütürken makinedeki kullanıcı hesabını belirtir.	String
kaynak	Çalıştırma komut betiğinin kaynağı.	MachineRunCommandScriptSource
timeoutInSeconds	Çalıştırma komutunu yürütmek için saniyeler içinde zaman aşımı.	Int

MachineRunCommandScriptSource

İsim	Açıklama	Değer
komut Kimliği	Önceden tanımlanmış yerleşik betiğin commandId değerini belirtir.	String
komut dosyası	Makinede yürütülecek betik içeriğini belirtir.	String
scriptUri	Betik indirme konumunu belirtir. Okuma erişimi olan bir Azure depolama blobunun SAS URI'si veya genel URI olabilir.	String
scriptUriManagedIdentity	Azure depolama blobu durumunda scriptUri'ye erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Azure depolama blobunun mevcut olduğundan ve yönetilen kimliğe 'Depolama Blobu Veri Okuyucusu' rol ataması ile blob kapsayıcısına erişim verildiğinden emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged.	RunCommandManagedIdentity

RunCommandInputParameter

İsim	Açıklama	Değer
isim	Komut parametresi adını çalıştırın.	dize (gerekli)
değer	Komut parametresini çalıştırma değeri.	dize (gerekli)

RunCommandManagedIdentity

İsim	Açıklama	Değer
clientId (İstemci Kimliği)	Kullanıcı tarafından atanan yönetilen kimliğin İstemci Kimliği (GUID değeri). Bu sağlanırsa ObjectId kullanılmamalıdır.	String
objectId (nesne kimliği)	Kullanıcı tarafından atanan yönetilen kimliğin Nesne Kimliği (GUID değeri). Bu sağlanırsa ClientId kullanılmamalıdır.	String

TrackedResourceTags

İsim	Açıklama	Değer

Kullanım Örnekleri

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Makineler/runCommands kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.HybridCompute/machines/runCommands kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridCompute/machines/runCommands@2025-02-19-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      asyncExecution = bool
      errorBlobManagedIdentity = {
        clientId = "string"
        objectId = "string"
      }
      errorBlobUri = "string"
      outputBlobManagedIdentity = {
        clientId = "string"
        objectId = "string"
      }
      outputBlobUri = "string"
      parameters = [
        {
          name = "string"
          value = "string"
        }
      ]
      protectedParameters = [
        {
          name = "string"
          value = "string"
        }
      ]
      runAsPassword = "string"
      runAsUser = "string"
      source = {
        commandId = "string"
        script = "string"
        scriptUri = "string"
        scriptUriManagedIdentity = {
          clientId = "string"
          objectId = "string"
        }
      }
      timeoutInSeconds = int
    }
  }
}

Özellik Değerleri

Microsoft.HybridCompute/machines/runCommands

İsim	Açıklama	Değer
konum	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
isim	Kaynak adı	karakter dizisi Kısıtlama -ları: Desen = `[a-zA-Z0-9-_\.]+` (gerekli)
ebeveyn_kimlik	Bu kaynağın üst öğesi olan kaynağın kimliği.	Tür kaynağı kimliği: makineler
özellikler	Çalıştırma Komutu Özelliklerini Açıklar	MachineRunCommandProperties
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü.
tür	Kaynak türü	"Microsoft.HybridCompute/machines/runCommands@2025-02-19-preview"

MachineRunCommandProperties

İsim	Açıklama	Değer
asyncExecution	Opsiyonel. True olarak ayarlanırsa, sağlama işlemi betik başlar başlamaz tamamlanır ve betiğin tamamlanmasını beklemez.	Boole
errorBlobManagedIdentity	errorBlobUri depolama blob'una erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Yönetilen kimliğe 'Depolama Blob Verileri Katkıda Bulunanı' rol ataması ile blob kapsayıcısına erişim verildiğine emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged	RunCommandManagedIdentity
errorBlobUri	Betik hata akışının karşıya yüklendiği Azure depolama blobunu belirtir. Okuma, ekleme, oluşturma, yazma erişimi olan bir SAS URI'sini kullanın VEYA bloba VM erişimi sağlamak için yönetilen kimliği kullanın. ErrorBlobManagedIdentity parametresine bakın.	String
outputBlobManagedIdentity	outputBlobUri depolama blob'una erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Yönetilen kimliğe 'Depolama Blob Verileri Katkıda Bulunanı' rol ataması ile blob kapsayıcısına erişim verildiğine emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged	RunCommandManagedIdentity
outputBlobUri	Betik çıktı akışının karşıya yüklendiği Azure depolama blobunu belirtir. Okuma, ekleme, oluşturma, yazma erişimi olan bir SAS URI'sini kullanın VEYA bloba VM erişimi sağlamak için yönetilen kimliği kullanın. outputBlobManagedIdentity parametresine bakın.	String
Parametreler	Betik tarafından kullanılan parametreler.	RunCommandInputParameter[]
protectedParameters	Betik tarafından kullanılan parametreler.	RunCommandInputParameter[]
runAsPassword	Çalıştır komutunu yürütürken makinedeki kullanıcı hesabı parolasını belirtir.	karakter dizisi Kısıtlama -ları: Hassas değer. Güvenli parametre olarak geçirin.
runAsUser	Run komutunu yürütürken makinedeki kullanıcı hesabını belirtir.	String
kaynak	Çalıştırma komut betiğinin kaynağı.	MachineRunCommandScriptSource
timeoutInSeconds	Çalıştırma komutunu yürütmek için saniyeler içinde zaman aşımı.	Int

MachineRunCommandScriptSource

İsim	Açıklama	Değer
komut Kimliği	Önceden tanımlanmış yerleşik betiğin commandId değerini belirtir.	String
komut dosyası	Makinede yürütülecek betik içeriğini belirtir.	String
scriptUri	Betik indirme konumunu belirtir. Okuma erişimi olan bir Azure depolama blobunun SAS URI'si veya genel URI olabilir.	String
scriptUriManagedIdentity	Azure depolama blobu durumunda scriptUri'ye erişimi olan kullanıcı tarafından atanan yönetilen kimlik. Sistem tarafından atanan kimlik durumunda boş bir nesne kullanın. Azure depolama blobunun mevcut olduğundan ve yönetilen kimliğe 'Depolama Blobu Veri Okuyucusu' rol ataması ile blob kapsayıcısına erişim verildiğinden emin olun. Kullanıcı tarafından atanan kimlik söz konusu olduğunda, bunu VM'nin kimliği altına eklediğinizden emin olun. Yönetilen kimlik ve Komut Çalıştır hakkında daha fazla bilgi için bkz. https://aka.ms/ManagedIdentity ve https://aka.ms/RunCommandManaged.	RunCommandManagedIdentity

RunCommandInputParameter

İsim	Açıklama	Değer
isim	Komut parametresi adını çalıştırın.	dize (gerekli)
değer	Komut parametresini çalıştırma değeri.	dize (gerekli)

RunCommandManagedIdentity

İsim	Açıklama	Değer
clientId (İstemci Kimliği)	Kullanıcı tarafından atanan yönetilen kimliğin İstemci Kimliği (GUID değeri). Bu sağlanırsa ObjectId kullanılmamalıdır.	String
objectId (nesne kimliği)	Kullanıcı tarafından atanan yönetilen kimliğin Nesne Kimliği (GUID değeri). Bu sağlanırsa ClientId kullanılmamalıdır.	String

TrackedResourceTags

İsim	Açıklama	Değer

Aracılığıyla paylaş

Microsoft.HybridCompute makineleri/runCommands 2025-02-19-preview

Bicep kaynak tanımı

Kaynak biçimi

Özellik Değerleri

Microsoft.HybridCompute/machines/runCommands

MachineRunCommandProperties

MachineRunCommandScriptSource

RunCommandInputParameter

RunCommandManagedIdentity

TrackedResourceTags

ARM şablonu kaynak tanımı

Kaynak biçimi

Özellik Değerleri

Microsoft.HybridCompute/machines/runCommands

MachineRunCommandProperties

MachineRunCommandScriptSource

RunCommandInputParameter

RunCommandManagedIdentity

TrackedResourceTags

Kullanım Örnekleri

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Kaynak biçimi

Özellik Değerleri

Microsoft.HybridCompute/machines/runCommands

MachineRunCommandProperties

MachineRunCommandScriptSource

RunCommandInputParameter

RunCommandManagedIdentity

TrackedResourceTags

Geri Bildirim

Ek kaynaklar