Remove-DscConfigurationDocument
Eltávolít egy konfigurációs dokumentumot a DSC konfigurációs tárából.
Syntax
Default (Alapértelmezett)
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 (.mof fájlt) a Windows PowerShell Desired State Configuration (DSC) konfigurációs tárából. A konfiguráció során a Start-DscConfiguration parancsmag egy .mof fájlt másol 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 karbantartást végez.
Ez a parancsmag csak a Windows RT 8.1, Windows 8.1 és Windows Server 2012 R2 2014. novemberi összegző frissítésénekrészeként érhető el.
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ókért írja be a következőt Get-Help New-CimSession:
A második parancs eltávolítja a CimSession $Session tárolt 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 a AsJob paramétert, a parancs egy, a feladatot jelképező objektumot ad vissza, majd megjeleníti a parancssort. A munkamenetben a feladat befejezéséig folytathatja a munkát.
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 a 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 a Windows PowerShellt a Futtatás rendszergazdaként lehetőséggel kell megnyitnia. További információkért lásd: about_Remote_Requirements.
További információ a Windows PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Ülés |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Stage
Megadja, hogy melyik konfigurációs dokumentumot szeretné 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.
Paramétertulajdonságok
| Típus: | Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Current, Pending, Previous |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 0 értéket ad meg, akkor a Windows PowerShell a számítógépen futó CIM-parancsmagok száma alapján kiszámítja a parancsmag optimális szabályozási korlátját. A szabályozási korlát csak az aktuális parancsmagra vonatkozik, a munkamenetre és a számítógépre nem.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
