Update-DscConfiguration

  • Başvuru
Modül:
PSDesiredStateConfiguration

Çekme sunucusunu güncelleştirilmiş yapılandırma için denetler ve uygular.

Syntax

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-DscConfiguration Cmdlet bir çekme sunucusuna bağlanır, düğümdeki geçerli yapılandırmadan farklıysa yapılandırmayı indirir ve ardından yapılandırmayı bilgisayara uygular.

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: Yapılandırmayı güncelleştirme

Update-DscConfiguration -Wait -Verbose

Bu komutu çalıştırdıktan sonra sunucu kayıtlı çekme hizmetine bağlanır, atanan en son yapılandırmayı indirir ve ardından uygular. Wait ve Verbose parametreleri isteğe bağlıdır. Etkileşimli olarak çalışırken bu parametreler, yapılandırma uygulanırken ilerleme ve başarı veya başarısızlık hakkında gerçek zamanlı geri bildirim sağlar.

Örnek 2: CIM oturumu üzerinden bağlanarak yapılandırmayı güncelleştirme

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Update-DscConfiguration -CimSession $Session -Wait

İlk komut cmdlet'ini New-CimSession kullanarak bir CIM oturumu oluşturur ve ardından CimSession nesnesini değişkeninde $Session depolar. Komut sizden bir parola ister. Daha fazla bilgi için Get-Help New-CimSession yazın.

İkinci komut, içinde depolanan $SessionCimSession içinde belirtilen bilgisayarı güncelleştirir. komutu Wait parametresini belirtir. Konsol, geçerli komut bitene kadar ek komutları kabul etmez.

Parametreler

-CimSession

Cmdlet'i uzak bir 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. Varsayılan, yerel bilgisayardaki geçerli oturumdur.

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

-ComputerName

Bilgisayar adları dizisini belirtir. Cmdlet, yapılandırma ayarlarını bu parametrenin belirttiği bilgisayarlara uygular.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
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

-Credential

Hedef bilgisayar için PSCredential nesnesi olarak bir kullanıcı adı ve parola belirtir. PSCredential nesnesi almak için cmdlet'ini Get-Credential kullanın. Daha fazla bilgi için Get-Help Get-Credential yazın.

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

-JobName

İş için kolay bir ad belirtir. Bu parametreyi belirtirseniz, cmdlet bir iş olarak çalışır ve bir İş nesnesi döndürür.

Varsayılan olarak, Windows PowerShell jobN adını atar; burada N tamsayıdır.

Wait parametresini belirtirseniz, bu parametreyi belirtmeyin.

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

-ThrottleLimit

Cmdlet'i ç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 bağlı olarak 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

-Wait

Cmdlet'in tüm yapılandırma görevlerini tamamlayana kadar konsolu engellediğini gösterir.

Bu parametreyi belirtirseniz JobName parametresini belirtmeyin.

Type:SwitchParameter
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