Set-AzVMRunCommand

  • Başvuru
Modül:
Az.Compute

Run komutunu oluşturma veya güncelleştirme işlemi.

Sözdizimi

Set-AzVMRunCommand
   -ResourceGroupName <String>
   -RunCommandName <String>
   -VMName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-AsyncExecution]
   [-ErrorBlobManagedIdentityClientId <String>]
   [-ErrorBlobManagedIdentityObjectId <String>]
   [-ErrorBlobUri <String>]
   [-OutputBlobManagedIdentityClientId <String>]
   [-OutputBlobManagedIdentityObjectId <String>]
   [-OutputBlobUri <String>]
   [-Parameter <IRunCommandInputParameter[]>]
   [-ProtectedParameter <IRunCommandInputParameter[]>]
   [-RunAsPassword <String>]
   [-RunAsUser <String>]
   [-ScriptUriManagedIdentityClientId <String>]
   [-ScriptUriManagedIdentityObjectId <String>]
   [-SourceCommandId <String>]
   [-SourceScript <String>]
   [-SourceScriptUri <String>]
   [-Tag <Hashtable>]
   [-TimeoutInSecond <Int32>]
   [-TreatFailureAsDeploymentFailure]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMRunCommand
   -ResourceGroupName <String>
   -RunCommandName <String>
   -VMName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-AsyncExecution]
   [-ErrorBlobManagedIdentityClientId <String>]
   [-ErrorBlobManagedIdentityObjectId <String>]
   [-ErrorBlobUri <String>]
   [-OutputBlobManagedIdentityClientId <String>]
   [-OutputBlobManagedIdentityObjectId <String>]
   [-OutputBlobUri <String>]
   [-Parameter <IRunCommandInputParameter[]>]
   [-ProtectedParameter <IRunCommandInputParameter[]>]
   [-RunAsPassword <String>]
   [-RunAsUser <String>]
   [-ScriptUriManagedIdentityClientId <String>]
   [-ScriptUriManagedIdentityObjectId <String>]
   [-Tag <Hashtable>]
   [-TimeoutInSecond <Int32>]
   [-TreatFailureAsDeploymentFailure]
   -ScriptLocalPath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Run komutunu oluşturma veya güncelleştirme işlemi.

Örnekler

Örnek 1: Depolama blobu SAS URL'si kullanarak VM'de Çalıştır Komutu oluşturma veya güncelleştirme

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceScriptUri "https://myst.blob.core.windows.net/mycontainer/myscript.ps1?sp=r&st=2022-10-27T21:02:35Z&se=2022-10-28T05:02:35Z&spr=https&sv=2021-06-08&sr=b&sig=0I%2FIiYayRwHasfasasfdasdfasdeTsQjLnpZjA%3D"

Location      Name         Type
--------      ----         ----
eastus2euap   MyRunCommand Microsoft.Compute/virtualMachines/runCommands

.ps1 betiği içeren bir depolama blobunun SAS URL'sini kullanarak Bir Windows VM'de Çalıştır Komutu oluşturun veya güncelleştirin. Not SAS URL'si bloba okuma erişimi sağlamalıdır. SAS URL'si için 24 saatlik bir süre sonu önerilir. SAS URL'leri Blob'un seçenekleri kullanılarak Azure portalında veya New-AzStorageBlobSASToken kullanılarak SAS belirteci kullanılarak oluşturulabilir. New-AzStorageBlobSASToken kullanarak SAS belirteci oluşturuyorsanız, New-AzStorageBlobSASToken'den SAS URL'niz = temel blob URL'si + "?" + SAS belirteciniz.

Örnek 2: Yerel bir betik dosyası kullanarak VM'de Çalıştır Komutunu oluşturun veya güncelleştirin.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"

Location      Name         Type
--------      ----         ----
eastus2euap   MyRunCommand Microsoft.Compute/virtualMachines/runCommands

Cmdlet'in yürütüldüğü istemci makinesinde bulunan yerel bir betik dosyasını kullanarak VM'de Çalıştır Komutunu oluşturun veya güncelleştirin.

Örnek 3: Betik metnini kullanarak bir VM'de Çalıştır Komutu oluşturun veya güncelleştirin.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand2 -Location EastUS2EUAP -SourceScript "id; echo HelloWorld"

Location      Name          Type
--------      ----          ----
eastus2euap   MyRunCommand2 Microsoft.Compute/virtualMachines/runCommands

Betik içeriğini doğrudan -SourceScript parametresine geçiren bir VM'de Çalıştır Komutunu oluşturun veya güncelleştirin. Birden çok komutu sınırlandırmak için ';' kullanın.

Örnek 4: CommandId kullanarak bir VM'de Komut Çalıştır'ı oluşturun veya güncelleştirin.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate

Location      Name         Type
--------      ----         ----
eastus2euap   MyRunCommand Microsoft.Compute/virtualMachines/runCommands

Önceden var olan commandId'sini kullanarak bir VM'de Çalıştır Komutu oluşturun veya güncelleştirin. Kullanılabilir commandId'ler Get-AzVMRunCommandDocument kullanılarak alınabilir.

Örnek 5: Vm'de Çalıştır Komutunu oluşturun veya güncelleştirin ve standart çıkış ile standart hata iletilerini çıkışa akışla aktarıp Ekleme blobları hatası oluştu.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand3 -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -OutputBlobUri "https://vivst.blob.core.windows.net/vivcontainer/output.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5hasfadsfasdF4jIkRJra4S5FlEo%3D" -ErrorBlobUri "https://vivst.blob.core.windows.net/vivcontainer/error.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5h%asfasdfgdT%2F4jasfasdf5FlEo%3D"

Location      Name          Type
--------      ----         ----
eastus2euap   MyRunCommand3 Microsoft.Compute/virtualMachines/runCommands

Vm'de Çalıştır Komutunu oluşturun veya güncelleştirin ve standart çıkış ve standart hata iletilerini çıkışa akışla aktarıp Blob ekleme hatası oluştu. Not çıktısı ve hata blobları AppendBlob türünde olmalıdır ve SAS URL'leri bloba okuma, ekleme, oluşturma, yazma erişimi sağlamalıdır. SAS URL'si için 24 saatlik bir süre sonu önerilir. Çıktı veya hata blobu yoksa AppendBlob türünde bir blob oluşturulur. SAS URL'leri Blob'un seçenekleri kullanılarak Azure portalında veya New-AzStorageBlobSASToken kullanılarak SAS belirteci kullanılarak oluşturulabilir. New-AzStorageBlobSASToken kullanarak SAS belirteci oluşturuyorsanız, New-AzStorageBlobSASToken'den SAS URL'niz = temel blob URL'si + "?" + SAS belirteciniz.

Örnek 6: Bir VM'de Çalıştır Komutunu oluşturun veya güncelleştirin, RunAsUser ve RunAsPassword parametrelerini kullanarak Komutu Çalıştır'ı farklı bir kullanıcı olarak çalıştırın.

Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -RunAsUser myusername -RunAsPassword mypassword

Location      Name         Type
--------      ----         ----
eastus2euap   MyRunCommand Microsoft.Compute/virtualMachines/runCommands

Bir VM'de Çalıştır Komutu oluşturun veya güncelleştirin, RunAsUser ve RunAsPassword parametrelerini kullanarak Run Command'u farklı bir kullanıcı olarak çalıştırın. RunA'ların düzgün çalışması için VM yöneticisine başvurun ve kullanıcının VM'ye eklendiğinden, kullanıcının Çalıştır Komutu (Dizinler, Dosyalar, Ağ vb.) tarafından erişilen kaynaklara erişimi olduğundan ve Windows VM'sinde 'İkincil Oturum Açma' hizmetinin vm üzerinde çalıştığından emin olun.

Parametreler

-AsJob

Komutu iş olarak çalıştırma

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AsyncExecution

isteğe bağlı. True olarak ayarlanırsa, sağlama işlemi betik başlar başlamaz tamamlanır ve betiğin tamamlanmasını beklemez.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

DefaultProfile parametresi işlevsel değil. Cmdlet'i farklı bir abonelikte yürütürken kullanılabilir olduğunda SubscriptionId parametresini kullanın.

Tür:PSObject
Diğer adlar:AzureRMContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ErrorBlobManagedIdentityClientId

Kullanıcı tarafından atanan yönetilen kimliğin İstemci Kimliği (GUID değeri). Bu sağlanırsa ObjectId kullanılmamalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ErrorBlobManagedIdentityObjectId

Kullanıcı tarafından atanan yönetilen kimliğin Nesne Kimliği (GUID değeri). Bu sağlanırsa ClientId kullanılmamalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Location

Kaynak konumu

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-NoWait

Komutu zaman uyumsuz olarak çalıştırma

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-OutputBlobManagedIdentityClientId

Kullanıcı tarafından atanan yönetilen kimliğin İstemci Kimliği (GUID değeri). Bu sağlanırsa ObjectId kullanılmamalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-OutputBlobManagedIdentityObjectId

Kullanıcı tarafından atanan yönetilen kimliğin Nesne Kimliği (GUID değeri). Bu sağlanırsa ClientId kullanılmamalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Parameter

Betik tarafından kullanılan parametreler. Oluşturmak için PARAMETRE özellikleri için NOTLAR bölümüne bakın ve karma tablo oluşturun.

Tür:IRunCommandInputParameter[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProtectedParameter

Betik tarafından kullanılan parametreler. Oluşturmak için PROTECTEDPARAMETER özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IRunCommandInputParameter[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Kaynak grubunun adı.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RunAsPassword

Çalıştır komutunu yürütürken VM'de kullanıcı hesabı parolasını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RunAsUser

Çalıştır komutunu yürütürken VM'de kullanıcı hesabını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RunCommandName

Sanal makine çalıştırma komutunun adı.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ScriptLocalPath

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ScriptUriManagedIdentityClientId

Kullanıcı tarafından atanan yönetilen kimliğin İstemci Kimliği (GUID değeri). Bu sağlanırsa ObjectId kullanılmamalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ScriptUriManagedIdentityObjectId

Kullanıcı tarafından atanan yönetilen kimliğin Nesne Kimliği (GUID değeri). Bu sağlanırsa ClientId kullanılmamalıdır.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SourceCommandId

Önceden tanımlanmış yerleşik betiğin commandId değerini belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SourceScript

VM'de yürütülecek betik içeriğini belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SourceScriptUri

Betik indirme konumunu belirtir. Okuma erişimi olan bir Azure depolama blobunun SAS URI'si veya genel URI olabilir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SubscriptionId

Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.

Tür:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Tag

Kaynak etiketleri

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TimeoutInSecond

Çalıştırma komutunu yürütmek için saniyeler içinde zaman aşımı.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TreatFailureAsDeploymentFailure

isteğe bağlı. true olarak ayarlanırsa, betikteki herhangi bir hata dağıtımda başarısız olur ve ProvisioningState Başarısız olarak işaretlenir. False olarak ayarlanırsa ProvisioningState yalnızca çalıştırma komutunun uzantılar platformu tarafından çalıştırılıp çalıştırılmadığını yansıtır; betik hatası durumunda betiğin başarısız olup olmadığını göstermez. ExecutionMessage, output, error hatasını görmek için betik hatası durumunda çalıştırma komutunun örnek görünümüne bakın: https://aka.ms/runcommandmanaged#get-execution-status-and-results

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-VMName

Çalıştırma komutunun oluşturulması veya güncelleştirilmesi gereken sanal makinenin adı.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Çıkışlar

IVirtualMachineRunCommand