Bagikan melalui

Publish-DscConfiguration

  • Referensi
Modul:
PSDesiredStateConfiguration

Menerbitkan konfigurasi DSC ke sekumpulan komputer.

Sintaks

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Deskripsi

Publish-DscConfiguration Cmdlet menerbitkan dokumen konfigurasi Windows PowerShell Desired State Configuration (DSC) pada set komputer. Cmdlet ini tidak menerapkan konfigurasi. Konfigurasi diterapkan oleh cmdlet Start-DscConfiguration saat digunakan dengan parameter UseExisting atau ketika mesin DSC menjalankan siklus konsistensinya. Mesin DSC juga dikenal sebagai Local Configuration Manager (LCM).

Cmdlet ini sangat berguna ketika fragmen beberapa dokumen konfigurasi dikirimkan. Ketika beberapa fragmen dokumen konfigurasi dikirimkan, mereka menimpa fragmen dokumen konfigurasi yang lebih lama.

Contoh

Contoh 1: Menerbitkan konfigurasi ke komputer jarak jauh

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

Perintah ini menerbitkan konfigurasi ke komputer jarak jauh. Pengguna yang menjalankan cmdlet harus menjadi administrator di komputer jarak jauh.

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 satu atau beberapa komputer tempat cmdlet ini menerbitkan konfigurasi.

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 kredensial yang digunakan untuk mengakses perangkat target.

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

-Force

Memaksa cmdlet untuk menyelesaikan. Jika mode refresh Local Configuration Manager diatur ke PULL, penggunaan parameter ini mengubahnya menjadi PUSH dan mengaktifkan publikasi konfigurasi DSC. Selain itu, jika konfigurasi DSC yang tertunda ada, penggunaan parameter ini menimpa konfigurasi yang tertunda.

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

-Path

Menentukan jalur yang berisi konfigurasi untuk diterbitkan ke komputer target.

Type:String
Position:0
Default value:None
Required:True
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

-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