다음을 통해 공유

Disable-ScheduledJob

  • 참조
모듈:
PSScheduledJob

예약된 작업을 사용하지 않도록 설정합니다.

Syntax

Disable-ScheduledJob
       [-InputObject] <ScheduledJobDefinition>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Id] <Int32>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Name] <String>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Disable-ScheduledJob cmdlet은 예약된 작업을 일시적으로 사용하지 않도록 설정합니다. 사용하지 않도록 설정하면 모든 작업 속성이 유지되며 작업 트리거도 사용할 수 있지만 트리거 시 예약된 작업이 자동으로 시작되지 않습니다. Start-Job cmdlet을 사용하여 비활성 예약된 작업을 시작하거나 사용하지 않도록 설정된 예약된 작업을 템플릿으로 사용할 수 있습니다.

예약된 작업을 사용하지 않도록 설정하기 위해 Disable-ScheduledJob cmdlet은 예약된 작업의 Enabled 속성을 False($false)로 설정합니다. 예약된 작업을 다시 사용하도록 설정하려면 Enable-ScheduledJob cmdlet을 사용합니다.

Disable-ScheduledJob은 Windows PowerShell 포함된 PSScheduledJob 모듈의 작업 예약 cmdlet 컬렉션 중 하나입니다.

예약된 작업에 대한 자세한 내용은 PSScheduledJob 모듈의 정보 항목을 참조하세요. PSScheduledJob 모듈을 가져온 다음 다음을 Get-Help about_Scheduled* 입력하거나 about_Scheduled_Jobs 확인합니다.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1: 예약된 작업 사용 안 함

PS C:\> Disable-ScheduledJob -ID 2 -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False

이 명령은 로컬 컴퓨터에서 ID가 2인 예약된 작업을 사용하지 않도록 설정합니다. 출력은 명령의 결과를 보여 줍니다.

예제 2: 예약된 모든 작업 사용 안 함

PS C:\> Get-ScheduledJob | Disable-ScheduledJob -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        False
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     False
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       False

이 명령은 로컬 컴퓨터에서 모든 예약된 작업을 사용하지 않도록 설정합니다. Get-ScheduledJob cmdlet을 사용하여 예약된 모든 작업을 가져와 서 Disable-ScheduledJob cmdlet을 사용하여 사용하지 않도록 설정합니다.

Enable-ScheduledJob cmdlet을 사용하여 예약된 작업을 다시 사용하도록 설정하고 Start-Job cmdlet을 사용하여 예약되지 않은 작업을 실행할 수 있습니다.

Disable-ScheduledJob 은 이미 사용하지 않도록 설정된 예약된 작업을 사용하지 않도록 설정하면 경고 또는 오류를 생성하지 않으므로 조건 없이 예약된 모든 작업을 사용하지 않도록 설정할 수 있습니다.

예제 3: 선택한 예약된 작업 사용 안 함

PS C:\> Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

이 명령은 자격 증명이 포함되지 않은 예약된 작업을 사용하지 않도록 설정합니다. 자격 증명이 없는 작업은 작업을 만든 사용자의 사용 권한으로 실행됩니다.

명령은 Get-ScheduledJob cmdlet을 사용하여 컴퓨터에서 예약된 모든 작업을 가져옵니다. 파이프라인 운영자는 예약된 작업을 자격 증명이 없는 예약된 작업을 선택하는 Where-Object cmdlet으로 보냅니다. 이 명령은 NOT(!) 연산자를 사용하며 예약된 작업의 Credential 속성을 참조합니다. 다른 파이프라인 연산자가 선택한 예약된 작업을 Disable-ScheduledJob cmdlet으로 보내면 이 cmdlet이 작업을 사용하지 않도록 설정합니다.

예제 4: 원격 컴퓨터에서 예약된 작업 사용 안 함

PS C:\> Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

이 명령은 두 원격 컴퓨터 Srv01 및 Srv10에서 TestJob scheduled 작업을 사용하지 않도록 설정합니다.

명령은 Invoke-Command cmdlet을 사용하여 Srv01 및 Srv10 컴퓨터에서 Disable-ScheduledJob 명령을 실행합니다. Disable-ScheduledJob의 Name 매개 변수를 사용하여 각 컴퓨터에서 TestJob 예약된 작업을 선택합니다.

예제 5: 전역 ID로 예약된 작업 사용 안 함

The first command demonstrates one way of finding the GlobalID of a scheduled job. The command uses the Get-ScheduledJob cmdlet to get the scheduled jobs on the computer. A pipeline operator (|) sends the scheduled jobs to the Format-Table cmdlet, which displays the Name, GlobalID, and Command properties of each job in a table.
PS C:\> Get-ScheduledJob | Format-Table -Property Name, GlobalID, Command -Autosize
Name             GlobalId                             Command
----             --------                             -------
ArchiveProjects1 a26a0b3d-b4e6-44d3-8b95-8706ef621f7c C:\Scripts\Archive-DxProjects.ps1
Inventory        3ac37e5d-84c0-4a8f-9661-7e88ebb8f914 \\Srv01\Scripts\Get-FullInventory.ps1
Backup-Scripts   4d0cc6be-c082-48d1-baec-1bd8278f3c81  Copy-Item C:\CurrentScripts\*.ps1 -Destination C:\BackupScripts
Test-HelpFiles   d77020ca-f20d-42be-86c8-fc64df97db90 .\Test-HelpFiles.ps1
Test-HelpFiles   2f1606d2-c6cf-4bef-8b1c-ae36a9cc9934 .\Test-DomainHelpFiles.ps1

The second command uses the  Get-ScheduledJob cmdlet to get the scheduled jobs on the computer. A pipeline operator (|) sends the scheduled jobs to the Where-Object cmdlet, which selects the scheduled job with the specified global ID. Another pipeline operator sends the job to the **Disable-ScheduledJob** cmdlet, which disables it.
PS C:\> Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

이 예제에서는 전역 ID를 사용하여 예약된 작업을 사용하지 않도록 설정하는 방법을 보여 줍니다. 예약된 작업의 GlobalID 속성 값은 고유 식별자(GUID)입니다. 여러 컴퓨터에서 예약된 작업을 사용하지 않도록 설정하는 경우와 같이 정밀도가 필요할 때 GlobalID 값을 사용합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
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

사용하지 않도록 설정할 예약된 작업을 지정합니다. ScheduledJobDefinition 개체가 포함된 변수를 입력하거나 ScheduledJobDefinition 개체(예: Get-ScheduledJob 명령)를 가져오는 명령이나 식을 입력합니다. ScheduledJobDefinition 개체를 Disable-ScheduledJob으로 파이프할 수도 있습니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
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

예약된 작업을 Disable-ScheduledJob으로 파이프할 수 있습니다.

출력

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Passthru 매개 변수를 사용할 경우 Disable-ScheduledJob은 사용하지 않도록 설정된 예약된 작업을 반환합니다. 그러지 않으면 이 cmdlet에서 출력이 생성되지 않습니다.

참고

  • Disable-ScheduledJob 은 이미 사용하지 않도록 설정된 예약된 작업을 사용하지 않도록 설정하는 데 사용하는 경우 경고 또는 오류를 생성하지 않습니다.