Start-DscConfiguration
將組態套用至節點。
Syntax
Start-DscConfiguration
[-Wait]
[-Force]
[[-Path] <String>]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
[[-Path] <String>]
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-UseExisting]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-DscConfiguration
[-Wait]
[-Force]
-CimSession <CimSession[]>
[-ThrottleLimit <Int32>]
[-UseExisting]
[-JobName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Cmdlet 會將設定 Start-DscConfiguration 套用至節點。 搭配 UseExisting 參數使用時，會套用目的電腦上的現有組態。 指定電腦名稱稱或使用 Common Information Model (CIM) 會話，指定您要套用設定的電腦。
根據預設，此 Cmdlet 會建立工作，並傳回 Job 物件。 如需背景工作的詳細資訊，請輸入 Get-Help about_Jobs 。 若要以互動方式使用此 Cmdlet，請指定 Wait 參數。
指定 Verbose 參數，以查看此 Cmdlet 在套用組態設定時如何運作的詳細資料。
範例
範例 1：套用組態設定
Start-DscConfiguration -Path "C:\DSC\Configurations\"此命令會將組態設定從 C:\DSC\Configurations\ 套用至具有該資料夾中設定的每部電腦。 此命令會為所部署的每個目標節點，傳回 Job 物件。
範例 2：套用組態設定並等候設定完成
Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose此命令會將設定從 C:\DSC\Configurations\ 套用至本機電腦。 此命令會為所部署的每個目標節點，傳回 Job 物件，在此案例中，只有本機電腦。 這個範例會指定 Verbose 參數。 因此，命令會在訊息繼續時傳送訊息至主控台。 此命令包含 Wait 參數。 因此，除非命令完成所有設定工作，否則您無法使用 主控台。
範例 3：使用 CIM 會話套用組態設定
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session這個範例會將組態設定套用至指定的電腦。 這個範例會針對名為 Server01 的電腦，建立一個搭配此 Cmdlet 使用的 CIM 工作階段。 或者，建立一個 CIM 工作階段的陣列，以便將該 Cmdlet 套用到多部指定的電腦。
第一個命令會使用 New-CimSession Cmdlet 建立 CIM 會話，然後將 CimSession 物件儲存在變數中 $Session 。 此命令會提示您輸入密碼。 如需詳細資訊，請鍵入 Get-Help NewCimSession。
第二個命令會將 組態設定從 C:\DSC\Configurations 套用至儲存在變數中 $SessionCimSession物件所識別的電腦。 在此範例中，變數 $Session 只包含名為 Server01 的電腦的 CIM 會話。 此命令會套用該組態。 此命令會為每部已設定的電腦建立 Job 物件。
參數
-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
停止目前在目的電腦上執行的組態作業，並開始新的 Start-Configuration 作業。 如果 Local Configuration Manager 的RefreshMode屬性設定為Pull，則指定此參數會將它變更為Push。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobName
指定工作的好記名稱。 如果您指定這個參數，Cmdlet 就會當做一個工作執行，而且它會傳回 Job 物件。
根據預設，Windows PowerShell指派名稱 JobN，其中 N 是整數。
如果您指定 Wait 參數，請不要指定此參數。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定包含組態設定檔之資料夾的檔案路徑。 此 Cmdlet 會發佈這些組態設定，並將其套用至具有指定路徑中設定檔案的電腦。 每個目標節點都必須具有下列格式的設定檔： <NetBIOS Name>.mof 。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| 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 |
-UseExisting
表示此 Cmdlet 會套用現有的組態。 設定可以藉由使用 Start-DscConfiguration 或使用 Publish-DscConfiguration Cmdlet 發行，來存在於目的電腦上。
在您為此 Cmdlet 指定此參數之前，請先檢閱Windows PowerShell 5.0 的新功能中的資訊。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
表示 Cmdlet 會封鎖主控台，直到它完成所有設定工作為止。
如果您指定此參數，請不要指定 JobName 參數。
| Type: | SwitchParameter |
| 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 |
