Bagikan melalui

Update-DscConfiguration

Modul:
PSDesiredStateConfiguration Module v1.1

Memeriksa server penarikan untuk konfigurasi yang diperbarui dan menerapkannya.

Sintaks

ComputerNameSet (Default) 

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

CimSessionSet 

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

Deskripsi

cmdlet Update-DscConfiguration tersambung ke server penarikan, mengunduh konfigurasi jika berbeda dari apa yang ada saat ini pada simpul, 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 cmdlet New-CimSession, lalu menyimpan objek CimSession dalam variabel $Session. 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 pada komputer jarak jauh. Masukkan nama komputer atau objek sesi, seperti output New-CimSession atau get-CimSession cmdlet. Defaultnya adalah sesi saat ini pada komputer lokal.

Properti parameter

Jenis:

CimSession[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

CimSessionSet
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ComputerName

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:CN, ServerName

Set parameter

ComputerNameSet
Position:1
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Credential

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

Properti parameter

Jenis:PSCredential
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

ComputerNameSet
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ThrottleLimit

Menentukan jumlah maksimum operasi bersamaan yang dapat dibuat 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.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Wait

Menunjukkan bahwa cmdlet memblokir konsol hingga menyelesaikan semua tugas konfigurasi.

Jika Anda menentukan parameter ini, jangan tentukan parameter JobName.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.