你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzConnectedMachineRunCommand

  • 参考
模块:
Az.ConnectedMachine

用于创建运行命令的操作。

语法

Update-AzConnectedMachineRunCommand
      -MachineName <String>
      -ResourceGroupName <String>
      -RunCommandName <String>
      [-SubscriptionId <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>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzConnectedMachineRunCommand
      -MachineName <String>
      -ResourceGroupName <String>
      -RunCommandName <String>
      [-SubscriptionId <String>]
      -RunCommandProperty <IMachineRunCommand>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzConnectedMachineRunCommand
      -RunCommandName <String>
      -MachineInputObject <IConnectedMachineIdentity>
      [-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>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzConnectedMachineRunCommand
      -RunCommandName <String>
      -MachineInputObject <IConnectedMachineIdentity>
      -RunCommandProperty <IMachineRunCommand>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzConnectedMachineRunCommand
      -InputObject <IConnectedMachineIdentity>
      [-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>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzConnectedMachineRunCommand
      -InputObject <IConnectedMachineIdentity>
      -RunCommandProperty <IMachineRunCommand>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

用于创建运行命令的操作。

示例

示例 1：更新计算机的运行命令

Update-AzConnectedMachineRunCommand -ResourceGroupName "az-sdk-test" -RunCommandName "myRunCommand3" -MachineName "testmachine" -SubscriptionId "e6fe6705-4c9c-4b54-81d2-e455780e20b8" -Tag @{Tag1="tag1"; Tag2="tag2"}

AsyncExecution                    : False
ErrorBlobManagedIdentityClientId  :
ErrorBlobManagedIdentityObjectId  :
ErrorBlobUri                      :
Id                                : /subscriptions/e6fe6705-4c9c-4b54-81d2-e455780e20b8/resourceGroups/az-sdk-test/prov
                                    iders/Microsoft.HybridCompute/machines/testmachine/runcommands/myRunCommand3
InstanceViewEndTime               : 12/5/2023 7:45:54 PM
InstanceViewError                 :
InstanceViewExecutionMessage      : RunCommand script execution completed
InstanceViewExecutionState        : Succeeded
InstanceViewExitCode              : 0
InstanceViewOutput                : Hello World!
InstanceViewStartTime             : 12/5/2023 7:45:53 PM
InstanceViewStatuses              :
Location                          : eastus2euap
Name                              : myRunCommand3
OutputBlobManagedIdentityClientId :
OutputBlobManagedIdentityObjectId :
OutputBlobUri                     :
Parameter                         :
ProtectedParameter                :
ProvisioningState                 : Succeeded
ResourceGroupName                 : az-sdk-test
RunAsPassword                     :
RunAsUser                         :
ScriptUriManagedIdentityClientId  :
ScriptUriManagedIdentityObjectId  :
SourceCommandId                   :
SourceScript                      : Write-Host Hello World!
SourceScriptUri                   :
SystemDataCreatedAt               :
SystemDataCreatedBy               :
SystemDataCreatedByType           :
SystemDataLastModifiedAt          :
SystemDataLastModifiedBy          :
SystemDataLastModifiedByType      :
Tag                               : {
                                      "Tag2": "tag2",
                                      "Tag1": "tag1"
                                    }
TimeoutInSecond                   : 0
Type                              : Microsoft.HybridCompute/machines/runcommands

更新计算机的运行命令

参数

-AsJob

以作业身份运行命令

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsyncExecution

可选。 如果设置为 true，则脚本启动后预配将立即完成，并且不会等待脚本完成。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorBlobManagedIdentityClientId

用户分配的托管标识的客户端 ID （GUID 值）。 如果未提供，则不应使用 ObjectId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorBlobManagedIdentityObjectId

用户分配的托管标识的对象 ID （GUID 值）。 如果未提供，则不应使用 ClientId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorBlobUri

指定将上传脚本错误流的 Azure 存储 Blob。 使用具有读取、追加、创建、写入访问权限的 SAS URI 或使用托管标识提供对 Blob 的 VM 访问权限。 引用 errorBlobManagedIdentity 参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

标识参数

Type:IConnectedMachineIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MachineInputObject

标识参数

Type:IConnectedMachineIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MachineName

混合计算机的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

异步运行命令

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputBlobManagedIdentityClientId

用户分配的托管标识的客户端 ID （GUID 值）。 如果未提供，则不应使用 ObjectId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputBlobManagedIdentityObjectId

用户分配的托管标识的对象 ID （GUID 值）。 如果未提供，则不应使用 ClientId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputBlobUri

指定将上传脚本输出流的 Azure 存储 Blob。 使用具有读取、追加、创建、写入访问权限的 SAS URI 或使用托管标识提供对 Blob 的 VM 访问权限。 引用 outputBlobManagedIdentity 参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Parameter

脚本使用的参数。

Type:IRunCommandInputParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProtectedParameter

脚本使用的参数。

Type:IRunCommandInputParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsPassword

在执行 run 命令时，指定计算机上的用户帐户密码。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsUser

在执行 run 命令时，指定计算机上的用户帐户。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunCommandName

run 命令的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunCommandProperty

描述运行命令

Type:IMachineRunCommand
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ScriptUriManagedIdentityClientId

用户分配的托管标识的客户端 ID （GUID 值）。 如果未提供，则不应使用 ObjectId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptUriManagedIdentityObjectId

用户分配的托管标识的对象 ID （GUID 值）。 如果未提供，则不应使用 ClientId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceCommandId

指定预定义内置脚本的 commandId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceScript

指定要在计算机上执行的脚本内容。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceScriptUri

指定脚本下载位置。 它可以是具有读取访问权限或公共 URI 的 Azure 存储 Blob 的 SAS URI。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

目标订阅的 ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

资源标记。

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutInSecond

执行 run 命令的超时（以秒为单位）。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

IConnectedMachineIdentity

IMachineRunCommand

输出

IMachineRunCommand