Start-DscConfiguration

  • 參考
模組:
PSDesiredStateConfiguration

將組態套用至節點。

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