다음을 통해 공유

Disable-ScheduledJob

  • 참조
모듈:
PSScheduledJob

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

구문

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

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

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

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

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

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

예제

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

다음은 로컬 컴퓨터에서 예약된 작업을 사용하지 않도록 설정하는 예제입니다.

Disable-ScheduledJob -ID 2 -PassThru

이 명령은 로컬 컴퓨터에서 ID가 2인 예약된 작업을 사용하지 않도록 설정합니다.

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

다음은 로컬 컴퓨터에서 예약된 모든 작업을 사용하지 않도록 설정하는 예제입니다.

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입니다.

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

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

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

다음은 예약된 작업에 자격 증명을 포함하지 않도록 설정하는 예제입니다.

Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

자격 증명이 없는 작업은 자격 증명을 만든 사용자의 권한으로 실행됩니다.

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

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

다음은 두 원격 컴퓨터에서 예약된 작업을 사용하지 않도록 설정하는 예제입니다.

Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

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

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

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

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

Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

첫 번째 명령은 예약된 작업의 GlobalID를 찾는 한 가지 방법을 보여 줍니다. 이 명령은 cmdlet을 Get-ScheduledJob 사용하여 컴퓨터에서 예약된 작업을 가져옵니다. 파이프라인 연산자(|)는 예약된 작업을 cmdlet으로 Format-Table 보내는데, 이 cmdlet은 테이블에 있는 각 작업의 Name, GlobalID 및 Command 속성을 표시합니다.

두 번째 명령은 cmdlet을 Get-ScheduledJob 사용하여 컴퓨터에서 예약된 작업을 가져옵니다. 파이프라인 연산자(|)는 지정된 전역 ID를 사용하여 예약된 작업을 Where-Object 선택하는 cmdlet에 예약된 작업을 보냅니다. 다른 파이프라인 연산자는 cmdlet에 Disable-ScheduledJob 작업을 전송하여 사용하지 않도록 설정합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

지정한 ID를 가진 예약된 작업을 사용하지 않도록 설정합니다. 예약된 작업의 ID를 입력합니다.

형식:Int32
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

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

형식:ScheduledJobDefinition
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

지정된 이름을 사용하여 예약된 작업을 사용하지 않도록 설정합니다. 예약된 작업의 이름을 입력합니다. 와일드카드가 지원됩니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

ScheduledJobDefinition

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

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

ScheduledJobDefinition

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 사용하지 않도록 설정된 예약된 작업을 반환합니다.

참고

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