Unregister-ScheduledJob

参考

模块:: PSScheduledJob

删除本地计算机上的计划作业。

语法

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

说明

Unregister-ScheduledJob cmdlet 可删除本地计算机中的计划作业。

删除或注销计划作业时， Unregister-ScheduledJob 会删除$home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs 目录) 中的计划作业 (目录，其中包含定义计划作业、作业执行历史记录和所有作业结果的 XML 文件。此操作还将删除任务计划程序中的作业。

Unregister-ScheduledJob 仅删除使用 Register-ScheduledJob cmdlet 创建的计划作业。它不会删除在任务计划程序中创建的计划作业。

可以使用 Unregister-ScheduledJob 的参数按 ID 或名称删除计划作业，或者将计划作业从 Get-ScheduledJob 管道传递给 Unregister-ScheduledJob。

Unregister-ScheduledJob 是 PSScheduledJob 模块（包含在 Windows PowerShell 中）中的一系列作业计划 cmdlet 之一。

有关计划作业的详细信息，请参阅 PSScheduledJob 模块中的“关于”主题。导入 PSScheduledJob 模块，然后键入：Get-Help about_Scheduled*，或参阅 about_Scheduled_Jobs。

此 cmdlet 是在 Windows PowerShell 3.0 中引入的。

示例

示例 1：删除计划作业

PS C:\> Unregister-ScheduledJob TestJob

此命令删除本地计算机上的 TestJob 计划作业。

示例 2：删除所有计划作业

PS C:\> Get-ScheduledJob | Unregister-ScheduledJob -Force
PS C:\> Unregister-ScheduledJob -Name "*" -Force

此示例显示了两个不同的命令，用于删除本地计算机上的所有计划作业。

第一个命令使用 Get-ScheduledJob cmdlet 获取本地计算机上的所有计划作业。管道运算符 (|) 将计划作业发送到 Unregister-ScheduleJob，它将删除这些作业。

第二个命令使用具有所有 (*) 的值的 Unregister-ScheduledJob 的 Name 参数来删除所有计划作业。

这两个命令都使用 Force 参数，该参数可删除计划作业，即使该作业的实例正在运行也是如此。

示例 3：删除远程计算机上的计划作业

PS C:\> Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

此命令删除名称以 Server01 远程计算机上的 Test 开头的计划作业。此命令使用 Invoke-Command cmdlet 在 Server02 计算机上运行 Unregister-ScheduledJob 命令。

参数

-Confirm

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

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

-Force

删除计划作业，即使该作业的实例正在运行也是如此。默认情况下，Unregister-ScheduledJob 不会中断正在运行的作业。

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

-Id

删除具有指定标识号 (ID) 的计划作业。在计算机上输入计划作业的 ID。

Type:	Int32[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定计划作业。请输入包含 ScheduledJob 对象的变量，或者键入获取 ScheduledJob 对象的命令或表达式，例如 Get-ScheduledJob 命令。还可以通过管道将 ScheduledJob 对象传递给 Unregister-JobTrigger。

Type:	ScheduledJobDefinition[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

删除具有指定名称的计划作业。在计算机上输入一个或多个计划作业的名称。支持通配符。

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

-WhatIf

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

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

输入

ScheduledJobDefinition

你可以通过管道将计划作业传递给 Unregister-ScheduledJob

输出

None

此 cmdlet 将不生成任何输出。

通过