共用方式為

Start-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

將設定套用至節點。

語法

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

Start-DscConfiguration Cmdlet 會將設定套用至節點。 與 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 的電腦建立 CIM 會話，以搭配 Cmdlet 使用。 或者，建立 CIM 會話陣列，以將 Cmdlet 套用至多個指定的電腦。

第一個命令會使用 New-CimSession Cmdlet 建立 CIM 會話，然後將 CimSession 物件儲存在 $Session 變數中。 命令會提示您輸入密碼。 如需詳細資訊，請輸入 Get-Help NewCimSession。

第二個命令會將組態設定從 C:\DSC\Configurations 套用至儲存在 $Session 變數中 CimSession 所識別的計算機。 在此範例中，$Session 變數只包含名為 Server01 之電腦的 CIM 會話。 命令會套用組態。 此命令會為每個設定的電腦建立 Job 物件。

參數

-CimSession

在遠端會話或遠端電腦上執行 Cmdlet。 輸入計算機名稱或會話物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前會話。

類型:CimSession[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ComputerName

指定計算機名稱的陣列。 此參數會將 Path 參數中設定檔的電腦限制為數位中指定的電腦。

類型:String[]
別名:CN, ServerName
Position:1
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定目標計算機的使用者名稱和密碼，做為 PSCredential 物件。 若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。 如需詳細資訊，請輸入 Get-Help Get-Credential。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

停止目前在目標計算機上執行的組態作業，並開始新的 Start-Configuration 作業。 如果 Local Configuration Manager 的 RefreshMode 屬性設定為 Pull，指定此參數會將它變更為 Push。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobName

指定作業的易記名稱。 如果您指定此參數，Cmdlet 會以作業的形式執行，並傳回 Job 物件。

根據預設，Windows PowerShell 會指派名稱 JobN，其中 N 是整數。

如果您指定 Wait 參數，請勿指定此參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定包含組態配置檔的資料夾檔案路徑。 此 Cmdlet 會將這些組態設定發佈並套用至具有指定路徑中配置檔的電腦。 每個目標節點都必須具有下列格式的設定檔：<NetBIOS Name>.mof。

類型:String
Position:0
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ThrottleLimit

指定可以建立以執行 Cmdlet 的並行作業數目上限。 如果省略此參數或輸入 0 的值，則 Windows PowerShell 會根據計算機上執行的 CIM Cmdlet 數目，計算 Cmdlet 的最佳節流限制。 節流限制僅適用於目前的 Cmdlet，不適用於工作階段或電腦。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseExisting

指出此 Cmdlet 會套用現有的組態。 設定可以存在於目標計算機上，方法是使用 Start-DscConfiguration 或使用 Publish-DscConfiguration Cmdlet 發行。

在指定這個 Cmdlet 的此參數之前，請先檢閱 windows PowerShell 5.0 中新功能中的資訊。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Wait

表示 Cmdlet 會封鎖主控台，直到它完成所有設定工作為止。

如果您指定此參數，請勿指定 JobName 參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False