Stop-DscConfiguration
실행 중인 구성 작업을 중지합니다.
구문
All
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Stop-DscConfiguration cmdlet은 실행 중인 구성 작업을 중지합니다. CIM(일반 정보 모델) 세션을 사용하여 이 cmdlet이 적용되는 컴퓨터를 지정합니다. 실행 중인 구성 작업이 없는 경우 이 cmdlet은 경고 메시지를 반환합니다.
예제
예제 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_Jobs 및 about_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출력)를 입력합니다.
매개 변수 속성
| 형식: | |
| 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를 참조하세요.