Stop-DscConfiguration

  • 참조
모듈:
PSDesiredStateConfiguration

실행 중인 구성 작업을 중지합니다.

Syntax

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet은 Stop-DscConfiguration 실행 중인 구성 작업을 중지합니다. CIM(일반 정보 모델) 세션을 사용하여 이 cmdlet이 적용되는 컴퓨터를 지정합니다. 실행 중인 구성 작업이 없는 경우 이 cmdlet은 경고 메시지를 반환합니다.

Stop-DscConfiguration는 Microsoft 지원 라이브러리에서 Windows RT 8.1, Windows 8.1 및 Windows Server 2012 R2에 대한 2014년 11월 업데이트 롤업의 일부로만 사용할 수 있습니다. 이 cmdlet을 사용하기 전에 Windows PowerShell 5.0의 새로운 기능에서 정보를 검토합니다.

예제

예제 1: 구성 작업 중지

이 예제에서는 cmdlet을 사용하여 New-CimSession CIM 세션을 만듭니다. CimSession 개체는 실행 중인 구성 작업을 중지하는 데 사용됩니다.

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession 는 ComputerName 매개 변수를 사용하여 Server01 컴퓨터를 지정합니다. Credential 매개 변수는 사용자 계정을 지정합니다. CimSession 개체는 변수에 $Session 저장됩니다. 명령을 실행하면 사용자 계정의 암호를 묻는 메시지가 표시됩니다.

Stop-DscConfiguration 는 CimSession 매개 변수와 에 $Session 저장된 개체를 사용하여 구성 작업을 중지합니다.

매개 변수

-AsJob

이 cmdlet이 명령을 백그라운드 작업으로 실행한다는 것을 나타냅니다. PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs 및 about_Remote_Jobs.

AsJob 매개 변수를 사용하려면 원격 작업을 위해 로컬 및 원격 컴퓨터를 구성해야 합니다. Windows Vista 이상 버전의 Windows 운영 체제에서는 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 열어야 합니다. 자세한 내용은 about_Remote_Requirements을 참조하세요.

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

-CimSession

원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름 또는 세션 개체(예: 또는 Get-CimSession의 New-CimSession 출력)를 입력합니다.

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

-Confirm

Stop-DscConfiguration 는 Confirm 매개 변수를 지원하지 않습니다. Confirm 매개 변수를 사용하면 오류가 표시됩니다.

Confirm를 지원하는 PowerShell cmdlet의 경우 매개 변수를 사용하면 명령을 실행하기 전에 확인하라는 메시지가 표시됩니다.

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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

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

-ThrottleLimit

cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다.

이 매개 변수를 생략하거나 값 0 이 입력되면 PowerShell은 컴퓨터에서 실행되는 CIM cmdlet 수에 따라 최적의 제한 제한을 계산합니다. 스로틀 제한은 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

None