共用方式為

Set-DscLocalConfigurationManager

  • 參考
模組:
PSDesiredStateConfiguration

將本機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\ 用至儲存在變數中 $SessionCimSession物件所識別的電腦。 在此範例中，變數 $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