Set-DscLocalConfigurationManager
將本機設定管理員 (LCM) 設定套用至節點。
語法
ComputerNameSet (預設值)
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>]
Description
Set-DscLocalConfigurationManager Cmdlet 會將 LCM 設定或中繼設定套用至節點。 指定電腦名稱或使用 Common Information Model (CIM) 會話來指定電腦。 如果您未指定目標計算機,Cmdlet 會將設定套用至本機計算機。
範例
範例 1:套用 LCM 設定
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"
此命令會將 C:\DSC\Configurations\ 的 LCM 設定套用至目標節點。 收到設定之後,LCM 會處理這些設定。
警告
如果儲存在指定資料夾中的相同計算機有多個中繼mofs,則只會套用第一個中繼mof。
範例 2:使用 CIM 會話套用 LCM 設定
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session
此範例會將 LCM 設定套用至電腦,並套用設定。 此範例會為名為 Server01 的電腦建立 CIM 會話,以搭配 Cmdlet 使用。 或者,建立 CIM 會話陣列,以將 Cmdlet 套用至多個指定的電腦。
第一個命令會使用 New-CimSession Cmdlet 建立 CIM 會話,然後將 CimSession 物件儲存在 $Session 變數中。 命令會提示您輸入密碼。 如需詳細資訊,請輸入 Get-Help New-CimSession。
第二個命令會將目標節點的 LCM 設定從 C:\DSC\Configurations\ 套用到儲存在 變數中 $Session 物件所識別的計算機。 在此範例中,$Session 變數只包含名為 Server01 之電腦的 CIM 會話。 命令會套用設定。 收到設定之後,LCM 會處理這些設定。
參數
-CimSession
在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件,例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前會話。
參數屬性
| 類型: | |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
CimSessionSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ComputerName
指定計算機名稱的陣列。 此參數會將 Path 參數中具有中繼組態檔的電腦限制為陣列中指定的電腦。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 中國, 伺服器名稱 |
參數集
ComputerNameSet
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
指定目標計算機的使用者名稱和密碼,做為 PSCredential 物件。 若要取得 PSCredential 物件,請使用 Get-Credential Cmdlet。 如需詳細資訊,請輸入 Get-Help Get-Credential。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ComputerNameSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制命令執行,而不要求使用者確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定包含組態配置檔的資料夾檔案路徑。 Cmdlet 會將這些 LCM 設定發佈並套用至具有指定路徑中配置檔的計算機。 每個目標節點都必須具有下列格式的設定檔:NetBIOS Name.meta.mof。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ThrottleLimit
指定可以建立以執行 Cmdlet 的並行作業數目上限。 如果省略此參數或輸入 0 的值,則 Windows PowerShell 會根據計算機上執行的 CIM Cmdlet 數目,計算 Cmdlet 的最佳節流限制。 節流限制僅適用於目前的 Cmdlet,不適用於工作階段或電腦。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。