Set-DscLocalConfigurationManager

  • Referensi
Modul:
PSDesiredStateConfiguration

Menerapkan pengaturan Configuration Manager Lokal (LCM) ke simpul.

Sintaks

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-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 di 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 New-CimSession cmdlet , lalu menyimpan objek CimSession dalam $Session variabel . 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 $Session variabel. Dalam contoh ini, $Session variabel 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 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 meta 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 cmdlet Get-Credential. 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

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

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

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