Update-DscConfiguration

  • Referensi
Modul:
PSDesiredStateConfiguration

Memeriksa server penarikan untuk konfigurasi yang diperbarui dan menerapkannya.

Sintaks

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>]

Deskripsi

Update-DscConfiguration Cmdlet terhubung ke server penarikan, mengunduh konfigurasi jika berbeda dari apa yang ada di simpul saat ini, lalu menerapkan konfigurasi ke komputer.

Cmdlet ini hanya tersedia sebagai bagian dari rollup pembaruan November 2014 untuk Windows RT 8.1, Windows 8.1, dan Windows Server 2012 R2.

Contoh

Contoh 1: Memperbarui konfigurasi

Update-DscConfiguration -Wait -Verbose

Setelah menjalankan perintah ini, server akan terhubung ke layanan penarikan terdaftar, mengunduh konfigurasi terbaru yang ditetapkan, lalu menerapkannya. Parameter Wait dan Verbose bersifat opsional. Saat bekerja secara interaktif, parameter ini digabungkan memungkinkan umpan balik real-time tentang kemajuan dan keberhasilan atau kegagalan saat menerapkan konfigurasi.

Contoh 2: Memperbarui konfigurasi dengan menyambungkan melalui sesi CIM

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

Perintah pertama membuat sesi CIM dengan menggunakan New-CimSession cmdlet , lalu menyimpan objek CimSession dalam $Session variabel . Perintah meminta kata sandi kepada Anda. Untuk informasi selengkapnya, ketik Get-Help New-CimSession.

Perintah kedua memperbarui komputer yang ditentukan dalam CimSession yang disimpan di $Session. Perintah menentukan parameter Tunggu . Konsol tidak menerima perintah tambahan hingga perintah saat ini selesai.

Parameter

-CimSession

Menjalankan cmdlet dalam sesi jarak jauh atau di komputer jarak jauh. Masukkan nama komputer atau objek sesi, seperti output cmdlet New-CimSession atau Get-CimSession . Defaultnya adalah sesi saat ini pada komputer lokal.

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

-ComputerName

Menentukan array nama komputer. Cmdlet menerapkan pengaturan konfigurasi ke komputer yang ditentukan parameter ini.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Credential

Menentukan nama pengguna dan kata sandi, sebagai objek PSCredential , untuk komputer target. Untuk mendapatkan objek PSCredential , gunakan Get-Credential cmdlet . Untuk informasi selengkapnya, ketik Get-Help Get-Credential.

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

-JobName

Menentukan nama yang mudah diingat untuk pekerjaan. Jika Anda menentukan parameter ini, cmdlet berjalan sebagai pekerjaan, dan mengembalikan objek Pekerjaan .

Secara default, Windows PowerShell menetapkan nama JobN di mana N adalah bilangan bulat.

Jika Anda menentukan parameter Tunggu , jangan tentukan parameter ini.

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

-ThrottleLimit

Menentukan jumlah maksimum operasi bersamaan yang dapat ditetapkan untuk menjalankan cmdlet. Jika parameter ini dihilangkan atau nilai 0 dimasukkan, maka Windows PowerShell menghitung batas pembatasan optimal untuk cmdlet berdasarkan jumlah cmdlet CIM yang berjalan di komputer. Batas pembatasan hanya berlaku untuk cmdlet saat ini, bukan ke sesi atau ke komputer.

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

-Wait

Menunjukkan bahwa cmdlet memblokir konsol hingga menyelesaikan semua tugas konfigurasi.

Jika Anda menentukan parameter ini, jangan tentukan parameter JobName .

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

-WhatIf

Menunjukkan yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

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