Set-DscLocalConfigurationManager
Menerapkan pengaturan Local Configuration Manager (LCM) ke simpul.
Sintaks
ComputerNameSet (Default)
Set-DscLocalConfigurationManager
[-Path] <String>
[[-ComputerName] <String[]>]
[-Force]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Set-DscLocalConfigurationManager
[-Path] <String>
-CimSession <CimSession[]>
[-Force]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Set-DscLocalConfigurationManager menerapkan pengaturan LCM, atau meta-configuration, ke simpul. Tentukan komputer dengan menentukan nama komputer atau dengan menggunakan sesi Common Information Model (CIM). Jika Anda tidak menentukan komputer target, cmdlet menerapkan pengaturan ke komputer lokal.
Contoh
Contoh 1: Menerapkan pengaturan LCM
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"
Perintah ini menerapkan pengaturan LCM dari C:\DSC\Configurations\ ke simpul yang ditargetkan. Setelah menerima pengaturan, LCM memprosesnya.
Peringatan
Jika ada beberapa meta mof untuk komputer yang sama yang disimpan dalam folder yang ditentukan, hanya meta mof pertama yang akan diterapkan.
Contoh 2: Menerapkan pengaturan LCM dengan menggunakan sesi CIM
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session
Contoh ini menerapkan pengaturan LCM ke komputer dan menerapkan pengaturan. 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 New-CimSession.
Perintah kedua menerapkan pengaturan LCM untuk simpul yang ditargetkan 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 pengaturan. Setelah menerima pengaturan, LCM memprosesnya.
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: | |
| 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. Parameter ini membatasi komputer yang memiliki dokumen konfigurasi meta 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
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 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 |
-Force
Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.
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 |
-Path
Menentukan jalur file folder yang berisi file pengaturan konfigurasi. Cmdlet menerbitkan dan menerapkan pengaturan LCM ini ke komputer yang memiliki file pengaturan di jalur yang ditentukan. Setiap simpul target harus memiliki file pengaturan dengan format berikut: NetBIOS Name.meta.mof.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | 0 |
| Wajib: | True |
| 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 |
-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.
