Remove-DscConfigurationDocument

  • Başvuru
Modül:
PSDesiredStateConfiguration

Bir yapılandırma belgesini DSC yapılandırma deposundan kaldırır.

Syntax

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

Description

Cmdlet, Remove-DscConfigurationDocument Windows PowerShell Desired State Configuration (DSC) yapılandırma deposundan bir yapılandırma belgesi (.mof dosyası) kaldırır. Yapılandırma Start-DscConfiguration sırasında, cmdlet bir .mof dosyayı 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çin Kası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, cmdlet'ini New-CimSession kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini $Session değişkeninde depolar. Komut sizden parola ister. Daha fazla bilgi için Get-Help New-CimSession yazın.

İkinci komut, $Session'de depolanan CimSession'da belirtilen bilgisayarın 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 ardından 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 cmdlet'ini Receive-Job 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 yönetici olarak çalıştır seçeneğiyle Windows PowerShell 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.

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

-CimSession

Cmdlet'i uzak bir oturumda veya uzak bir bilgisayarda çalıştırır. Veya cmdlet'inin New-CimSession çıkışı gibi bir bilgisayar adı veya Get-CimSession oturum nesnesi girin.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Stage

Hangi yapılandırma belgesinin kaldırılacağını belirtir. Birden çok belge belirtebilirsiniz. Bu parametrenin kabul edilebilir değerleri ş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.
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'ini çalıştırmak için oluşturulabilecek en fazla eşzamanlı işlem sayısını belirtir. Bu parametre atlanırsa veya değeri 0 girilirse, Windows PowerShell bilgisayarda çalışan CIM cmdlet'lerinin sayısına göre cmdlet için en uygun kısıtlama sınırını hesaplar. Kısıtlama sınırı yalnızca geçerli cmdlet'e uygulanır, oturuma veya bilgisayara uygulanmaz.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

None

Çıkışlar

None