Remove-DscConfigurationDocument
Bir yapılandırma belgesini DSC yapılandırma deposundan kaldırır.
Sözdizimi
Default EnterprisePublishing
Remove-DscConfigurationDocument
-Stage <Stage>
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-DscConfigurationDocument cmdlet'i, Windows PowerShell İstenen Durum Yapılandırması (DSC) yapılandırma deposundan bir yapılandırma belgesini (.mof dosyası) kaldırır. Yapılandırma sırasında Start-DscConfiguration cmdlet'i bir .mof dosyasını hedef bilgisayardaki bir klasöre kopyalar. Bu cmdlet bu yapılandırma belgesini kaldırır ve ek temizleme yapar.
Bu cmdlet yalnızca windows RT 8.1, Windows 8.1 ve Windows Server 2012 R2 içinKasım 2014 güncelleştirme paketi kapsamında kullanılabilir.
Örnekler
Örnek 1: Geçerli yapılandırma belgesini kaldırma
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Remove-DscConfigurationDocument -Stage Current -CimSession $Session
İlk komut, New-CimSession cmdlet'ini kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini $Session değişkeninde depolar. Komut sizden bir parola ister. Daha fazla bilgi için Get-Help New-CimSessionyazın.
İkinci komut, $Session depolanan CimSession belirtilen bilgisayar için geçerli yapılandırma belgesini kaldırır.
Parametreler
-AsJob
Bu cmdlet'in komutu arka plan işi olarak çalıştırdığını gösterir.
AsJob parametresini belirtirseniz, komut işi temsil eden bir nesne döndürür ve komut istemini görüntüler. İş bitene kadar oturumda çalışmaya devam edebilirsiniz.
İş yerel bilgisayarda oluşturulur ve uzak bilgisayarlardan alınan sonuçlar otomatik olarak yerel bilgisayara döndürülür. İşi yönetmek için İş cmdlet'lerini kullanın. İş sonuçlarını almak için Receive-Job cmdlet'ini kullanın.
Bu parametreyi kullanmak için yerel ve uzak bilgisayarların uzaktan iletişim için yapılandırılması ve Windows Vista'da ve Windows işletim sisteminin sonraki sürümlerinde Windows PowerShell'i Yönetici olarak çalıştır seçeneğiyle açmanız gerekir. Daha fazla bilgi için bkz. about_Remote_Requirements.
Windows PowerShell arka plan işleri hakkında daha fazla bilgi için bkz. about_Jobs ve about_Remote_Jobs.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-CimSession
Cmdlet'i uzak oturumda veya uzak bir bilgisayarda çalıştırır.
New-CimSession veya Get-CimSession cmdlet'inin çıkışı gibi bir bilgisayar adı veya oturum nesnesi girin.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Oturum |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Bu cmdlet'in, yapılandırma belgesini kaldırmadan önce çalışan yapılandırma işini durdurduğunu gösterir. Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Stage
Hangi yapılandırma belgesinin kaldırılacağını belirtir. Birden çok belge belirtebilirsiniz. Bu parametre için kabul edilebilir değerler şunlardır:
-
Current- Sistemin geçerli durumunu açıklayan yapılandırma belgesini kaldırın. -
Pending- Sistemin bekleyen durumunu açıklayan yapılandırma belgesini kaldırın. -
Previous- Sistemin önceki durumunu açıklayan yapılandırma belgesini kaldırın.
Parametre özellikleri
| Tür: | Microsoft.PowerShell.Cmdletization.GeneratedTypes.RemoveDscConfigurationDocument.Stage |
| Default value: | None |
| Kabul edilen değerler: | Current, Pending, Previous |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ThrottleLimit
cmdlet'ini çalıştırmak için oluşturulabilecek en fazla eşzamanlı işlem sayısını belirtir. Bu parametre atlanırsa veya 0 değeri girilirse, Windows PowerShell bilgisayarda çalışan CIM cmdlet'lerinin sayısına göre cmdlet için en uygun azaltma sınırını hesaplar. Kısıtlama sınırı yalnızca geçerli cmdlet'e uygulanır, oturuma veya bilgisayara uygulanmaz.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
