다음을 통해 공유

Remove-DscConfigurationDocument

  • 참조
모듈:
PSDesiredStateConfiguration

DSC 구성 저장소에서 구성 문서를 제거합니다.

구문

Remove-DscConfigurationDocument
      -Stage <Stage>
      [-Force]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-DscConfigurationDocument cmdlet은 Windows PowerShell DSC(필요한 상태 구성) 구성 저장소에서 구성 문서(.mof 파일)를 제거합니다. 구성 중에 Start-DscConfiguration cmdlet은 대상 컴퓨터의 폴더에 .mof 파일을 복사합니다. 이 cmdlet은 해당 구성 문서를 제거하고 추가 정리를 수행합니다.

이 cmdlet은 Windows RT 8.1, Windows 8.1 및 Windows Server 2012 R2 대한2014년 11월 업데이트 롤업의 일부로만 사용할 수 있습니다.

예제

예제 1: 현재 구성 문서 제거

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Remove-DscConfigurationDocument -Stage Current -CimSession $Session

첫 번째 명령은 New-CimSession cmdlet을 사용하여 CIM 세션을 만든 다음 CimSession 개체를 $Session 변수에 저장합니다. 이 명령은 암호를 묻는 메시지를 표시합니다. 자세한 내용은 Get-Help New-CimSession입력합니다.

두 번째 명령은 $Session 저장된 CimSession 지정된 컴퓨터의 현재 구성 문서를 제거합니다.

매개 변수

-AsJob

이 cmdlet이 명령을 백그라운드 작업으로 실행한다는 것을 나타냅니다.

AsJob 매개 변수를 지정하는 경우 명령은 작업을 나타내는 개체를 반환한 다음 명령 프롬프트를 표시합니다. 작업이 완료될 때까지 세션에서 작업을 계속할 수 있습니다. 작업이 로컬 컴퓨터에 만들어지고 원격 컴퓨터의 결과가 자동으로 로컬 컴퓨터로 반환됩니다. 작업을 관리하려면 작업 cmdlet을 사용합니다. 작업 결과를 얻으려면 Receive-Job cmdlet을 사용합니다.

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

Windows PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs 및 about_Remote_Jobs참조하세요.

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

-CimSession

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

형식:CimSession[]
별칭:Session
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

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

-Force

이 cmdlet은 구성 문서를 제거하기 전에 실행 중인 구성 작업을 중지했음을 나타냅니다. 사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

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

-Stage

제거할 구성 문서를 지정합니다. 여러 문서를 지정할 수 있습니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Current - 시스템의 현재 상태를 설명하는 구성 문서를 제거합니다.
  • Pending - 시스템의 보류 상태를 설명하는 구성 문서를 제거합니다.
  • Previous - 시스템의 이전 상태를 설명하는 구성 문서를 제거합니다.
형식:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
허용되는 값:Current, Pending, Previous
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ThrottleLimit

cmdlet을 실행하기 위해 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수를 생략하거나 0 값을 입력하면 Windows PowerShell은 컴퓨터에서 실행되는 CIM cmdlet 수에 따라 cmdlet에 대한 최적의 제한 제한을 계산합니다. 제한 제한은 세션이나 컴퓨터가 아닌 현재 cmdlet에만 적용됩니다.

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

-WhatIf

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

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

입력

None

출력

None