다음을 통해 공유

Remove-DscConfigurationDocument

  • 참조
모듈:
PSDesiredStateConfiguration

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

Syntax

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

Description

cmdlet은 Remove-DscConfigurationDocument Windows PowerShell Desired State Configuration(DSC) 구성 저장소에서 구성 문서(.mof파일)를 제거합니다. 구성 중에 cmdlet은 Start-DscConfiguration 대상 컴퓨터의 .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

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

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

매개 변수

-AsJob

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

AsJob 매개 변수를 지정하면 명령은 작업을 나타내는 개체를 반환한 다음 명령 프롬프트를 표시합니다. 작업이 완료될 때까지 세션에서 계속 작업할 수 있습니다. AsJob 매개 변수를 사용하는 경우 이 명령은 백그라운드 작업을 나타내는 개체를 즉시 반환합니다. 작업을 관리하려면 Job cmdlet을 사용합니다. 작업 결과를 얻으려면 cmdlet을 Receive-Job 사용합니다.

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

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

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

-CimSession

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

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

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-Force

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

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

-Stage

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

  • Current - 시스템의 현재 상태를 설명하는 구성 문서를 제거합니다.
  • Pending - 시스템의 보류 상태를 설명하는 구성 문서를 제거합니다.
  • Previous - 시스템의 이전 상태를 설명하는 구성 문서를 제거합니다.
Type:Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage
Accepted values:Current, Pending, Previous
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수를 생략하거나 값을 0 입력한 경우 Windows PowerShell 컴퓨터에서 실행되는 CIM cmdlet 수에 따라 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