New-CMWindowsServicingPlan

模組:

ConfigurationManager

建立 Windows 10 維護方案。

語法

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMWindowsServicingPlan Cmdlet 會建立 Windows 10 維護計劃。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：依集合標識符建立服務方案

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

第一個命令會建立語言清單，並將清單儲存在$Lang變數中。

第二個命令會建立搜尋字串清單，並將清單儲存在$Required變數中。 此搜尋字串會尋找至少一部計算機上所需的軟體更新，最多 100 部電腦。

第三個命令會建立軟體更新標題的清單，並將清單儲存在$Title變數中。

最後一個命令會取得名為 SUDP01 的軟體更新部署套件，然後使用標識碼MP40001A，為目標集合建立名為 Test 的 Windows 服務方案。 命令會新增儲存在 $Lang 中的升級篩選語言、儲存在 $Required 中所需的篩選條件，以及儲存在 $Title 中的軟體更新標題篩選器。

範例 2：依集合名稱建立服務方案

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

第一個命令會建立語言選取語言的清單，並將清單儲存在$LangSelect變數中。

第二個命令會取得名為 SUP02 的軟體更新部署套件，然後為名為 ColName02 的目標集合建立名為 Test02 的 Windows 服務方案。 命令會新增儲存在 $LangSelect 中的語言選取語言。

參數

-AlertTime

指定更新部署期限的整數位移。 規則會使用此值來指定規則產生警示的時機。 使用 AlertTimeUnit 參數指定時間單位。

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

-AlertTimeUnit

指定 AlertTime 參數的時間單位。 有效值為：

• 小時
• 天
• 星期
• 月份

類型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowRestart

指出當達到安裝期限時，是否允許在任何已定義的維護期間之外執行系統重新啟動。

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

指出當達到安裝期限時，是否允許在任何已定義的維護期間之外執行軟體安裝。

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

-AllowUseMeteredNetwork

指出是否允許用戶端在期限之後透過計量付費因特網連線下載內容，這可能會產生額外費用。

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

-AvailableImmediately

指出執行規則之後，是否可以儘快安裝軟體更新。

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

-AvailableTime

指定何時可以使用軟體更新。

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

-AvailableTimeUnit

指定軟體可用時間的時間單位類型。 有效值為：

• 小時
• 天
• 星期
• 月份

類型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Collection

指定要用於維護計劃的目標裝置集合物件。 若要取得裝置集合物件，請使用 Get-CMCollection 或 Get-CMDeviceCollection Cmdlet。

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

-CollectionId

指定要用於維護計劃的目標裝置集合標識碼。

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

-CollectionName

指定要用於維護計劃的目標裝置集合名稱。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DeadlineImmediately

指出是否在達到期限時儘快安裝必要的軟體更新。

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

-DeadlineTime

指定期限的時間單位數目。

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

-DeadlineTimeUnit

指定期限的時間單位類型。 有效值為：

• 小時
• 天
• 星期
• 月份

類型:	TimeUnitType
接受的值:	Hours, Days, Weeks, Months
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeploymentPackage

指定軟體更新部署套件。 若要取得軟體更新部署套件，請使用 Get-CMSoftwareUpdateDeploymentPackage Cmdlet。

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

-DeploymentRing

指定服務方案應套用的 Windows 整備狀態。 有效值為：

• CB
• 發行
• BusinessMainstream
• Cbb
• Ltsb

類型:	DeploymentRing
接受的值:	CB, Release, BusinessMainstream, Cbb, Ltsb
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定維護計劃的描述。

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

-DisableOperationManager

指出是否要在軟體更新期間停用 System Center Operations Manager 警示。

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

-DownloadFromInternet

指出是否要從因特網下載軟體更新。

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

-DownloadFromMicrosoftUpdate

指出如果慣用發佈點或遠端發佈點上無法使用軟體更新，計算機是否要從 Microsoft Update 下載內容。

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

-Enable

指出是否已啟用維護計劃。

類型:	Boolean
別名:	Enabled, EnableDeployment
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GenerateOperationManagerAlert

指出是否要在軟體更新期間產生 Operations Manager 警示。

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

-GenerateSuccessAlert

指出是否要產生成功部署的警示。

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

-Language

指定用來篩選要新增至服務方案之軟體升級的語言陣列。

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

-LanguageSelection

指定語言的陣列做為字串。 除了非語言特定的更新之外，計算機還會下載以指定語言提供的軟體更新。

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

-Location

指定下載更新所在的網路位置。

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

-Name

指定服務方案的名稱。 名稱必須是唯一的，有助於描述規則的目標，並從 Configuration Manager 站台中的其他人識別它。

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

-NoInstallOnRemote

指出是否允許在遠端系統上安裝更新。 如果您指定$True值，如果用戶端位於緩慢或不可靠的網路界限內，或用戶端使用內容的後援來源位置，則 Configuration Manager 不會安裝軟體更新。 如果您指定$False值，則會繼續安裝。

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

-NoInstallOnUnprotected

指出是否允許在未受保護的系統上安裝更新。 如果您指定$True值，如果任何慣用發佈點上都無法使用軟體更新，Configuration Manager 就不會下載並安裝軟體更新。 如果您指定$False值，則會繼續安裝。

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

-Required

指定搜尋字串的陣列，用來篩選將新增至服務方案的軟體升級。

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

-RunType

指定執行更新的模式。 有效值為：

• DoNotRunThisRuleAutomatically
• RunTheRuleAfterAnySoftwareUpdatePointSynchronization
• RunTheRuleOnSchedule

類型:	RunType
接受的值:	DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Schedule

指定從部署可用時間) (的期限時間。 若要建立排程，請使用 New-CMSchedule Cmdlet。

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

-SendWakeupPacket

指出是否要在部署開始之前將喚醒封包傳送至電腦。 如果此值$True，Configuration Manager 會喚醒計算機進入睡眠狀態。 如果此值$False，則不會喚醒計算機進入睡眠狀態。 若要讓電腦喚醒，您必須先設定網路喚醒。

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

-SuccessPercentage

以 0 到 99 的整數指定客戶端合規性的百分比。 如果合規性低於此百分比，Configuration Manager 會產生選擇性警示。

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

-SuppressRestartServer

指出當軟體更新需要系統重新啟動才能完成安裝程式時，伺服器上是否抑制系統重新啟動。

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

-SuppressRestartWorkstation

指出當軟體更新需要系統重新啟動才能完成安裝程式時，工作站上是否抑制系統重新啟動。

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

-Title

指定搜尋字串的陣列，用來篩選將新增至服務方案的軟體更新標題。

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

-UpdateDeploymentWaitDay

指定在您的環境中部署之前，Microsoft發佈新升級之後要等候的天數。

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

-UseBranchCache

指出是否要使用分支快取。 如果您指定$True值，用戶端會在相同的子網上共享內容。

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

-UserNotification

指定用戶視覺體驗的通知行為。 有效值為：

• DisplayAll
• DisplaySoftwareCenterOnly
• HideAll

類型:	UserNotificationType
接受的值:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseUtc

指出此部署的排程是否根據通用國際標準時間 (UTC) 進行評估。

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

-VerboseLevel

指定您希望客戶端針對此規則所建立之部署報告的詳細數據層級。 有效值為：

• AllMessages
• OnlyErrorMessages
• OnlySuccessAndErrorMessages

類型:	VerboseLevelType
接受的值:	OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

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

-WriteFilterHandling

指出變更是在期限或維護期間認可， (需要重新啟動) 。 如果設定為 $False，則會在重疊上套用內容，並在稍後認可。

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

輸入

None

輸出

System.Object

相關連結

• Get-CMCollection
• Get-CMDeviceCollection
• Get-CMSoftwareUpdateDeploymentPackage
• Get-CMWindowsServicingPlan