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

Disable-AzureBatchComputeNodeScheduling

禁用指定计算节点上的任务计划。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Disable-AzureBatchComputeNodeScheduling
       [-PoolId] <String>
       [-Id] <String>
       [-DisableSchedulingOption <DisableComputeNodeSchedulingOption>]
       -BatchContext <BatchAccountContext>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]
Disable-AzureBatchComputeNodeScheduling
       [[-ComputeNode] <PSComputeNode>]
       [-DisableSchedulingOption <DisableComputeNodeSchedulingOption>]
       -BatchContext <BatchAccountContext>
       [-DefaultProfile <IAzureContextContainer>]
       [<CommonParameters>]

说明

Disable-AzureBatchComputeNodeScheduling cmdlet 禁用指定计算节点上的任务计划。 计算节点是专用于特定应用程序工作负荷的 Azure 虚拟机。 在计算节点上禁用任务计划时,还可以选择确定当前在节点的任务队列中对作业执行的操作。 Disable-AzureBatchComputeNodeScheduling 允许执行以下操作:

  • 终止任务并将其放回作业队列中。 这使这些任务可以在另一个计算节点上重新计划。
  • 终止任务,并将其从作业队列中删除。 不会重新计划以这种方式停止的任务。
  • 等待当前执行的所有任务完成,然后禁用计算节点上的任务计划。
  • 等待所有正在运行的任务完成,并等待所有数据保留期到期,然后在计算节点上禁用任务计划。

示例

示例 1:在计算节点上禁用任务计划

PS C:\>$Context = Get-AzureRmBatchAccountKeys -AccountName "contosobatchaccount"
PS C:\> Disable-AzureBatchComputeNodeScheduling -PoolId "myPool" -Id "tvm-1783593343_34-20151117t222514z" -BatchContext $Context

这些命令在计算节点 tvm-1783593343_34-20151117t222514z 上禁用任务计划。 为此,示例中的第一个命令为批处理帐户 contosobatchaccount 创建对帐户密钥的对象引用。 此对象引用存储在名为$context的变量中。 然后,第二个命令使用此对象引用和 Disable-AzureBatchComputeNodeScheduling cmdlet 连接到池 myPool,并在节点 tvm-1783593343_34-20151117t222514z 上禁用任务计划。 由于 DisableComputeNodeSchedulingOptions 参数不包含当前在计算节点上运行的任何任务,因此将重新排队。

示例 2:禁用池中所有计算节点上的任务计划

PS C:\>$Context = Get-AzureRmBatchAccountKeys -AccountName "contosobatchaccount"
PS C:\> Get-AzureBatchComputeNode -PoolId "Pool06"  -BatchContext $Context | Disable-AzureBatchComputeNodeScheduling -BatchContext $Context

这些命令在批处理池池06 中的所有计算机节点上禁用任务计划。 若要执行此任务,示例中的第一个命令将创建对批处理帐户 contosobatchaccount 帐户的帐户密钥的对象引用。 此对象引用存储在名为$context的变量中。 然后,示例中的第二个命令使用此对象引用和 Get-AzureBatchComputeNode 返回 Pool06 中找到的所有计算节点的集合。 然后,该集合通过管道传递给 Disable-AzureBatchComputeNodeScheduling cmdlet,以禁用集合中每个计算节点上的任务计划。 由于 DisableComputeNodeSchedulingOptions 参数不包含当前在计算节点上运行的任何任务将被重新排队。

参数

-BatchContext

指定 此 cmdlet 用于与 Batch 服务交互的 BatchAccountContext 实例。 如果使用 Get-AzureRmBatchAccount cmdlet 获取 BatchAccountContext,则在与 Batch 服务交互时将使用 Microsoft Entra 身份验证。 若要改用共享密钥身份验证,请使用 Get-AzureRmBatchAccountKeys cmdlet 获取包含其访问密钥的 BatchAccountContext 对象。 使用共享密钥身份验证时,默认使用主访问密钥。 若要更改要使用的密钥,请设置 BatchAccountContext.KeyInUse 属性。

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

-ComputeNode

指定对禁用任务计划计算节点的对象引用。 此对象引用是使用 Get-AzureBatchComputeNode cmdlet 创建的,并将返回的计算节点对象存储在变量中。

Type:PSComputeNode
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-DisableSchedulingOption

指定此 cmdlet 如何处理当前正在禁用计划的计算机节点上运行的任何任务。 此参数的可接受值为:

  • 重新排队。 任务会立即停止,并返回到作业队列。 这样就可以在另一个计算节点上重新计划任务。 这是默认值。
  • Terminate。 任务会立即停止,并从作业队列中删除。 不会重新安排这些任务。
  • TaskCompletion。 在计算节点上禁用任务计划之前,当前正在运行的任务将能够完成。 不会在此节点上计划新任务。
  • RetainedData。 当前正在运行的任务将能够完成,数据保留期将在计算节点上禁用任务计划之前过期。 不会在此节点上计划新任务。
Type:Nullable<T>[DisableComputeNodeSchedulingOption]
Accepted values:Requeue, Terminate, TaskCompletion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定禁用任务计划的计算节点的 ID。

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

-PoolId

指定包含禁用任务计划的计算节点的批处理池的 ID。 如果使用 PoolId 参数,请不要在同一命令中使用 ComputeNode 参数。

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

输入

PSComputeNode

参数:ComputeNode (ByValue)

BatchAccountContext

参数:BatchContext (ByValue)

输出

Void