다음을 통해 공유


Stop-DscConfiguration

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

구문

All

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

Description

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

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

예제

예제 1: 구성 작업 중지

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

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

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

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

매개 변수

-AsJob

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

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-CimSession

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

매개 변수 속성

형식:

CimSession[]

Default value:None
와일드카드 지원:False
DontShow:False
별칭:세션

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

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

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Force

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ThrottleLimit

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

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

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

None