Start-DscConfiguration

Modul:

PSDesiredStateConfiguration Module v1.1

Menerapkan konfigurasi ke simpul.

Sintaks

ComputerNameAndPathSet (Default)

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

CimSessionAndPathSet

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

ComputerNameAndUseExistingSet

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

CimSessionAndUseExistingSet

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

Deskripsi

cmdlet Start-DscConfiguration 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: Terapkan pengaturan konfigurasi dan tunggu 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 berlanjut. Perintah ini mencakup 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. Contoh 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 cmdlet New-CimSession, lalu menyimpan objek CimSession dalam variabel $Session. 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 variabel $Session. Dalam contoh ini, variabel $Session 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 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

CimSessionAndPathSet

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

CimSessionAndUseExistingSet

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	CN, ServerName

Set parameter

ComputerNameAndPathSet

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

ComputerNameAndUseExistingSet

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

ComputerNameAndPathSet

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

ComputerNameAndUseExistingSet

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

-Force

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

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

-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

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

Properti parameter

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

Set parameter

ComputerNameAndPathSet

Position:	0
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CimSessionAndPathSet

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

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

Properti parameter

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

Set parameter

ComputerNameAndUseExistingSet

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

CimSessionAndUseExistingSet

Position:	Named
Wajib:	True
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.

Link Terkait

• Gambaran Umum Konfigurasi Status yang Diinginkan Windows PowerShell
• Get-DscConfiguration
• Get-DscConfigurationStatus
• Restore-DscConfiguration
• Stop-DscConfiguration
• Test-DscConfiguration
• Update-DscConfiguration