Megosztás a következőn keresztül:

Remove-DscConfigurationDocument

  • Referencia
Modul:
PSDesiredStateConfiguration

Eltávolít egy konfigurációs dokumentumot a DSC konfigurációs tárolójából.

Syntax

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

Description

A Remove-DscConfigurationDocument parancsmag eltávolít egy konfigurációs dokumentumot (.moffájlt) a Windows PowerShell Desired State Configuration (DSC) konfigurációs tárolóból. A konfiguráció során a Start-DscConfiguration parancsmag átmásolja a .mof fájlt a célszámítógép egyik mappájába. Ez a parancsmag eltávolítja a konfigurációs dokumentumot, és további tisztítást végez.

Ez a parancsmag csak a 2014. novemberi kumulatív frissítés részeként érhető el a Windows RT 8.1-re, Windows 8.1-re és Windows Server 2012 R2-re.

Példák

1. példa: Az aktuális konfigurációs dokumentum eltávolítása

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

Az első parancs létrehoz egy CIM-munkamenetet a New-CimSession parancsmag használatával, majd a CimSession objektumot a $Session változóban tárolja. A parancssor jelszó megadását kéri. További információért írja be a következőt: Get-Help New-CimSession.

A második parancs eltávolítja a $Session tárolt CimSession fájlban megadott számítógép aktuális konfigurációs dokumentumát.

Paraméterek

-AsJob

Azt jelzi, hogy ez a parancsmag háttérfeladatként futtatja a parancsot.

Ha megadja az AsJob paramétert, a parancs egy, a feladatot jelképező objektumot ad vissza, majd megjeleníti a parancssort. A munkamenetben folytathatja a munkát, amíg a feladat be nem fejeződik. A feladat a helyi számítógépen jön létre, és a távoli számítógépek eredményei automatikusan visszakerülnek a helyi számítógépre. A feladat kezeléséhez használja a Feladat parancsmagokat. A feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.

A paraméter használatához a helyi és távoli számítógépeket újra kell konfigurálni, a Windows Vista és a Windows operációs rendszer újabb verzióiban pedig meg kell nyitnia a Windows PowerShell a Futtatás rendszergazdaként beállítással. További információ: about_Remote_Requirements.

Az Windows PowerShell háttérfeladatokkal kapcsolatos további információkért lásd: about_Jobs és about_Remote_Jobs.

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

-CimSession

A parancsmagot távoli munkamenetben vagy távoli számítógépen futtatja. Adjon meg egy számítógépnevet vagy egy munkamenet-objektumot, például egy New-CimSession vagy Get-CimSession parancsmag kimenetét.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Force

Azt jelzi, hogy ez a parancsmag leállítja a futó konfigurációs feladatot, mielőtt eltávolítja a konfigurációs dokumentumot. Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

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

-Stage

Meghatározza, hogy melyik konfigurációs dokumentumot kell eltávolítani. Több dokumentumot is megadhat. A paraméter elfogadható értékei a következők:

  • Current – Távolítsa el a rendszer aktuális állapotát leíró konfigurációs dokumentumot.
  • Pending – Távolítsa el a rendszer függőben lévő állapotát leíró konfigurációs dokumentumot.
  • Previous – Távolítsa el a rendszer korábbi állapotát leíró konfigurációs dokumentumot.
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

Megadja a parancsmag futtatásához létrehozható egyidejű műveletek maximális számát. Ha ezt a paramétert nem adja meg, vagy egy értéket 0 ad meg, akkor Windows PowerShell kiszámítja a parancsmag optimális szabályozási korlátját a számítógépen futó CIM-parancsmagok száma alapján. A szabályozási korlát csak az aktuális parancsmagra vonatkozik, a munkamenetre és a számítógépre nem.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

None

Kimenetek

None