Set-DscLocalConfigurationManager
將本機Configuration Manager (LCM) 設定套用至節點。
Syntax
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>]
Description
Cmdlet 會將 Set-DscLocalConfigurationManager
LCM 設定或中繼組態套用至節點。 透過指定電腦名稱或使用通用訊息模型 (CIM) 工作階段指定電腦。 如果您沒有指定目標電腦,此 Cmdlet 會將設定套用到本機電腦。
範例
範例 1:套用 LCM 設定
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"
此命令會將 LCM 設定從 C:\DSC\Configurations\
套用至目標節點。 收到設定之後,LCM 會處理這些設定。
警告
如果儲存在指定資料夾中的相同電腦有多個中繼 mofs,則只會套用第一個中繼 mof。
範例 2:使用 CIM 會話套用 LCM 設定
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session
本範例會將 LCM 設定套用至電腦,並套用設定。 這個範例會針對名為 Server01 的電腦,建立一個搭配此 Cmdlet 使用的 CIM 工作階段。 或者,建立一個 CIM 工作階段的陣列,以便將該 Cmdlet 套用到多部指定的電腦。
第一個命令會使用 New-CimSession
Cmdlet 建立 CIM 會話,然後將 CimSession 物件儲存在變數中 $Session
。 此命令會提示您輸入密碼。 如需詳細資訊,請鍵入 Get-Help New-CimSession
。
第二個命令會將目標節點的 LCM 設定套 C:\DSC\Configurations\
用至儲存在變數中 $Session
CimSession物件所識別的電腦。 在此範例中,變數 $Session
只包含名為 Server01 的電腦的 CIM 會話。 此命令會套用這些設定。 收到設定之後,LCM 會處理這些設定。
參數
-CimSession
在遠端工作階段或遠端電腦上執行 Cmdlet。 輸入電腦名稱稱或會話物件,例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前工作階段。
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
指定電腦名稱的陣列。 此參數會將 Path 參數中具有中繼組態檔的電腦限制為數組中指定的檔。
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定目標電腦的使用者名稱和密碼,做為 PSCredential 物件。 若要取得 PSCredential 物件,請使用 Get-credential Cmdlet。 如需詳細資訊,請鍵入 Get-Help Get-Credential
。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
強制執行命令而不要求使用者確認。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
指定包含組態設定檔之資料夾的檔案路徑。 Cmdlet 會將這些 LCM 設定發佈並套用至具有指定路徑中設定檔案的電腦。 每個目標節點都必須具有下列格式的設定檔: NetBIOS Name.meta.mof
。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
指定為執行 Cmdlet 可建立的最大並行作業數。 如果省略此參數或輸入 的值 0
,則Windows PowerShell根據電腦上執行的 CIM Cmdlet 數目,計算 Cmdlet 的最佳節流限制。 節流限制僅適用於目前 Cmdlet,不適用於工作階段或電腦。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |