Update-DscConfiguration
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 |
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk