Set-AzVmssVMRunCommand
VMSS VM çalıştırma komutunu oluşturma veya güncelleştirme işlemi.
Syntax
Set-AzVmssVMRunCommand
-InstanceId <String>
-ResourceGroupName <String>
-RunCommandName <String>
-VMScaleSetName <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-AzVmssVMRunCommand
-InstanceId <String>
-ResourceGroupName <String>
-RunCommandName <String>
-VMScaleSetName <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
VMSS VM çalıştırma komutunu oluşturma veya güncelleştirme işlemi.
Örnekler
Örnek 1: Depolama blobu SAS URL'si kullanarak VMSS VM örneğinde Çalıştır Komutu oluşturma veya güncelleştirme
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -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 VMSS VM örneğinde Çalıştır Komutunu 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-Az Depolama BlobSASToken kullanılarak SAS belirteci kullanılarak oluşturulabilir. New-Az Depolama BlobSASToken kullanarak SAS belirteci oluşturuyorsanız, New-Az Depolama BlobSASToken'den SAS URL'niz = temel blob URL'si + "?" + SAS belirteciniz.
Örnek 2: Yerel bir betik dosyası kullanarak VMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1"
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommandsCmdlet'in yürütüldüğü istemci makinesinde bulunan yerel bir betik dosyasını kullanarak VMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin.
Örnek 3: Betik metnini kullanarak BIR VMSS VM örneğinde Çalıştır Komutu oluşturun veya güncelleştirin.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSSL -InstanceId 1 -RunCommandName MyRunCommand2 -Location EastUS2EUAP -SourceScript "id; echo HelloWorld"
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand2 Microsoft.Compute/virtualMachines/runCommandsBetik içeriğini doğrudan -SourceScript parametresine geçirerek VMSS VM örneğinde Ç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 VMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceCommandId DisableWindowsUpdate
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommandsÖnceden var olan commandId'sini kullanarak BIR VMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin. Kullanılabilir commandId'ler Get-AzVMRunCommandDocument kullanılarak alınabilir.
Örnek 5: VMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin ve standart çıkış ile standart hata iletilerini çıkışa akışla aktarıp Blob ekleme hatası oluştu.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 1 -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/runCommandsVMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin ve standart çıkış ile standart hata iletilerini çıkışa ve ekleme blobları hatasına akışla aktarabilirsiniz. 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-Az Depolama BlobSASToken kullanılarak SAS belirteci kullanılarak oluşturulabilir. New-Az Depolama BlobSASToken kullanarak SAS belirteci oluşturuyorsanız, New-Az Depolama BlobSASToken'den SAS URL'niz = temel blob URL'si + "?" + SAS belirteciniz.
Örnek 6: Bir VMSS VM örneğinde Çalıştır Komutunu oluşturun veya güncelleştirin, RunAsUser ve RunAsPassword parametrelerini kullanarak Komutunu Farklı Bir Kullanıcı olarak çalıştırın.
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 1 -RunCommandName MyRunCommand -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -RunAsUser myusername -RunAsPassword mypassword
Location Name Type
-------- ---- ----
eastus2euap MyRunCommand Microsoft.Compute/virtualMachines/runCommandsBIR VMSS VM örneğinde Çalıştır Komutu oluşturun veya güncelleştirin, RunAsUser ve RunAsPassword parametrelerini kullanarak Komutunu Farklı Bir Kullanıcı Olarak Çalıştır'ı ç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
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceId
Sanal makinenin örnek kimliği.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Kaynak konumu
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoWait
Komutu zaman uyumsuz olarak çalıştırma
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IRunCommandInputParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IRunCommandInputParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Kaynak grubunun adı.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsPassword
Çalıştır komutunu yürütürken VM'de kullanıcı hesabı parolasını belirtir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsUser
Çalıştır komutunu yürütürken VM'de kullanıcı hesabını belirtir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunCommandName
Sanal makine çalıştırma komutunun adı.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptLocalPath
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceCommandId
Önceden tanımlanmış yerleşik betiğin commandId değerini belirtir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceScript
VM'de yürütülecek betik içeriğini belirtir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceScriptUri
Betik indirme konumunu belirtir. Okuma erişimi olan bir Azure depolama blobunun SAS URI'si veya genel URI olabilir.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Kaynak etiketleri
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutInSecond
Çalıştırma komutunu yürütmek için saniyeler içinde zaman aşımı.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMScaleSetName
VM ölçek kümesinin adı.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Çıkışlar
Azure PowerShell
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin