Start-DscConfiguration

  • Referensi
Modul:
PSDesiredStateConfiguration

Menerapkan konfigurasi ke simpul.

Sintaks

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Deskripsi

Start-DscConfiguration Cmdlet menerapkan konfigurasi ke simpul. Saat digunakan dengan parameter UseExisting , konfigurasi yang ada pada komputer target diterapkan. Tentukan komputer mana yang ingin Anda terapkan konfigurasinya dengan menentukan nama komputer atau dengan menggunakan sesi Common Information Model (CIM).

Secara default, cmdlet ini membuat pekerjaan dan mengembalikan objek Pekerjaan . Untuk informasi selengkapnya tentang pekerjaan latar belakang, ketik Get-Help about_Jobs. Untuk menggunakan cmdlet ini secara interaktif, tentukan parameter Tunggu .

Tentukan parameter Verbose untuk melihat detail apa yang dilakukan cmdlet saat menerapkan pengaturan konfigurasi.

Contoh

Contoh 1: Menerapkan pengaturan konfigurasi

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Perintah ini menerapkan pengaturan konfigurasi dari C:\DSC\Configurations\ ke setiap komputer yang memiliki pengaturan di folder tersebut. Perintah mengembalikan objek Pekerjaan untuk setiap simpul target yang disebarkan.

Contoh 2: Menerapkan pengaturan konfigurasi dan menunggu konfigurasi selesai

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Perintah ini menerapkan konfigurasi dari C:\DSC\Configurations\ ke komputer lokal. Perintah mengembalikan objek Pekerjaan untuk setiap simpul target yang disebarkan, dalam hal ini, hanya komputer lokal. Contoh ini menentukan parameter Verbose . Oleh karena itu, perintah mengirim pesan ke konsol saat dilanjutkan. Perintah menyertakan parameter Tunggu . Oleh karena itu, Anda tidak dapat menggunakan konsol hingga perintah menyelesaikan semua tugas konfigurasi.

Contoh 3: Menerapkan pengaturan konfigurasi dengan menggunakan sesi CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

Contoh ini menerapkan pengaturan konfigurasi ke komputer tertentu. Contohnya membuat sesi CIM untuk komputer bernama Server01 untuk digunakan dengan cmdlet . Atau, buat array sesi CIM untuk menerapkan cmdlet ke beberapa komputer tertentu.

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 NewCimSession.

Perintah kedua menerapkan pengaturan konfigurasi dari C:\DSC\Configurations ke komputer yang diidentifikasi oleh objek CimSession yang disimpan dalam $Session variabel . Dalam contoh ini, $Session variabel berisi sesi CIM hanya untuk komputer bernama Server01. Perintah menerapkan konfigurasi. Perintah membuat objek Pekerjaan untuk setiap komputer yang dikonfigurasi.

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. Parameter ini membatasi komputer yang memiliki dokumen konfigurasi dalam parameter Jalur untuk yang ditentukan dalam array.

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

-Force

Menghentikan operasi konfigurasi yang saat ini berjalan pada komputer target dan memulai operasi Start-Configuration baru. Jika properti RefreshMode dari Configuration Manager Lokal diatur ke Tarik, menentukan parameter ini mengubahnya menjadi Dorong.

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

-Path

Menentukan jalur file folder yang berisi file pengaturan konfigurasi. Cmdlet ini menerbitkan dan menerapkan pengaturan konfigurasi ini ke komputer yang memiliki file pengaturan di jalur yang ditentukan. Setiap simpul target harus memiliki file pengaturan dengan format berikut: <NetBIOS Name>.mof.

Type:String
Position:0
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

-UseExisting

Menunjukkan bahwa cmdlet ini menerapkan konfigurasi yang ada. Konfigurasi dapat ada di komputer target dengan memberlakukan menggunakan Start-DscConfiguration atau dengan publikasi menggunakan cmdlet Publish-DscConfiguration.

Sebelum Anda menentukan parameter ini untuk cmdlet ini, tinjau informasi di Apa yang Baru di Windows PowerShell 5.0.

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