New-CMSoftwareUpdateAutoDeploymentRule
(ADR) 建立軟體更新的自動部署規則。
Syntax
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-Collection <IResultObject>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionId <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionName <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-CMSoftwareUpdateAutoDeploymentRule Cmdlet 會建立軟體更新的 ADR) (自動部署規則。 當規則執行時,Configuration Manager將符合規則資格的更新新增至軟體更新群組。 Configuration Manager伺服器會下載內容檔案,並將其複製到發佈點,然後更新用戶端電腦。 如需詳細資訊,請 參閱自動部署軟體更新。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:建立基本 ADR
此命令會針對名為Desktops 的集合和名為Updates123的部署套件,建立名為DeploymentRule07的部署規則。 此規則會部署發行項識別碼為 117的更新。
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"
範例 2:建立使用排程和其他屬性的 ADR
此範例會建立使用已定義排程的自動部署規則。 部署會根據排程進行。
第一個命令會建立星期三的排程,並將排程物件儲存在 $Schedule 變數中。 如需詳細資訊,請參閱 New-CMSchedule。
第二個命令會針對使用儲存在變數中之排程物件的更新建立自動部署規則。 此命令會指定許多參數的值。
$Schedule = New-CMSchedule -DayOfWeek Wednesday
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $True
範例 3:建立多種語言的 ADR
此範例會建立 ADR,以新增三種語言的 語言 準則:英文、匈牙利文和中文 (簡體中文、中國) 。 它也會為 Windows 新增這些語言,並Office 365更新二進位檔來下載。 此範例規則預設為停用。
New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"
參數
-AddToExistingSoftwareUpdateGroup
指出規則是否會新增至現有的軟體更新群組。
- 如果此值為
$True
,則每次執行規則並尋找新的更新時,都會將它們新增至現有的更新群組。 - 如果此值為
$False
,則會建立新的更新群組。
指定現有的更新群組,或使用 -DeploymentPackageName 參數指派新更新群組的名稱。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTime
指定更新部署期限的整數位移。 規則會使用此值來指定規則產生警示的時機。 使用 -AlertTimeUnit 參數指定時間單位。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTimeUnit
指定 -AlertTime 參數的時間單位。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRestart
指出如果更新部署是在維護期間之外進行,是否允許電腦重新開機。 維護期間是用於電腦維護和更新的指定時間週期。
- 如果此值為
$True
,Configuration Manager視需要重新開機電腦以完成更新。 - 如果此值為
$False
,Configuration Manager不會重新開機電腦。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
指出即使排程在維護期間之外,還是會進行更新部署。 維護期間是用於電腦維護和更新的指定時間週期。
- 如果此值為
$True
,Configuration Manager部署更新,即使排程的時間落在服務視窗之外也一樣。 - 如果此值為
$False
,Configuration Manager不會在服務視窗外部署更新。 它會等候,直到可以在服務視窗中部署為止。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUseMeteredNetwork
指出是否允許用戶端在期限之後透過計量付費網際網路連線下載內容,這可能會產生額外費用。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Architecture
使用此參數可在 ADR屬性的[軟體更新] 頁面上設定 Architecture 屬性篩選。
Type: | ArchitectureType[] |
Aliases: | Architectures |
Accepted values: | Arm64, Itanium, X64, X86 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ArticleId
指定軟體更新的準則陣列做為字串。 此規則會將具有符合指定準則之發行項識別碼的軟體更新新增至軟體更新群組。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableImmediately
指出此規則是否會在更新可用時立即部署更新。 如果您選取 的 $False
值,請使用 -AvailableTime 和 -AvailableTimeUnit 參數來指定在規則執行後多久才能部署更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTime
將一段時間指定為整數。 Configuration Manager會在規則執行之後部署更新。 使用 -AvailableTimeUnit 參數指定時間單位。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTimeUnit
指定 -AvailableTime 參數的時間單位。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BulletinId
指定軟體更新的準則陣列做為字串。 此規則會將具有符合指定準則之公告識別碼的軟體更新新增至軟體更新群組。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CMTag
此屬性會保留供日後使用。
Type: | CMTagTypes[] |
Accepted values: | None, UUP |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
指定集合物件作為自動部署規則的目標。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
指定集合識別碼作為自動部署規則的目標。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
指定集合名稱作為自動部署規則的目標。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
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 |
-ContentSize
使用此參數可在 ADR 屬性的 [軟體更新] 頁面上設定內容大小 (KB) 屬性篩選。
Type: | String[] |
Aliases: | ContentSizes |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomSeverity
指定軟體更新的自訂嚴重性類型陣列。 此規則會將自訂嚴重性層級符合指定準則的軟體更新新增至軟體更新群組。
Type: | SeverityType[] |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateReleasedOrRevised
指定軟體更新的發行或修訂日期。 此規則會將日期符合指定準則的軟體更新新增至軟體更新群組。
Type: | DateReleasedOrRevisedType |
Accepted values: | Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineImmediately
指出是否要在規則執行時立即強制執行期限。 如果您指定 的 $False
值,請使用 -DeadlineTime 和 -DeadlineTimeUnit 參數來指定規則執行後多久的時間來設定期限。 在期限之後,Configuration Manager安裝必要的更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTime
將一段時間指定為整數。 更新的期限是在規則執行之後的時間長。 使用 -DeadlineTimeUnit 參數指定時間單位。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTimeUnit
指定 -DeadlineTime 參數的時間單位。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentPackage
使用此參數來指定要與此自動部署規則搭配使用的部署套件物件。 若要不需要封裝,請將值設定為 $null
。
Type: | IResultObject |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DeploymentPackageName
指定要與此自動部署規則搭配使用的部署套件名稱。 若要不需要封裝,請將值設定為 $null
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentRing
Type: | DeploymentRing |
Accepted values: | CB, Release, BusinessMainstream, Cbb, Ltsb |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployWithoutLicense
指出規則是否在沒有授權的情況下部署更新。
- 如果您指定 的
$True
值,Configuration Manager部署此規則的所有更新,並核准任何授權合約。 - 如果此值為
$False
,Configuration Manager只會部署不包含授權或已核准授權合約的更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定軟體更新自動部署規則的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableOperationManager
指出是否要在軟體更新期間停用 System Center Operations Manager 警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadFromInternet
指出電腦是否從網際網路下載軟體更新。 如果您指定 的 $False
值,請指定電腦可以使用 -Location 參數下載更新的替代位置。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadFromMicrosoftUpdate
指出如果遠端發佈點慣用發佈點上無法使用該內容,電腦是否從 Microsoft Update 下載內容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
指定在建立自動部署規則之後,是否啟用自動部署規則。
Type: | Boolean |
Aliases: | Enabled, EnableDeployment |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnabledAfterCreate
指出是否要在此規則執行之後啟用相關聯軟體更新群組的軟體部署。 如果此值為 $False
,請手動部署軟體更新群組。
Type: | Boolean |
Aliases: | EnableAfterCreate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateFailureAlert
如果規則失敗,請建立Configuration Manager警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateOperationManagerAlert
指出是否要在軟體更新期間產生 Operations Manager 警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateSuccessAlert
指出是否要產生成功部署的警示。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsServicingPlan
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Language
指定軟體更新的語言準則字串陣列。 此規則會將語言符合指定準則的軟體更新新增至軟體更新群組。
使用主控台中顯示的語言格式。 例如:
English
Hungarian
Chinese (Simplified, PRC)
字串陣列的格式為: "English","Hungarian","Chinese (Simplified, PRC)"
提示
如果您在 Windows 具有當地語系化 UI 的電腦上執行此 Cmdlet,語言名稱可能會不同。 例如,英文版的 Windows 使用「丹麥文」,但丹麥文版本的 Windows 使用 「Dansk」。
Type: | String[] |
Aliases: | Languages, UpdateLocales, UpdateLocale |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LanguageSelection
指定語言的字串陣列。 用戶端會下載以指定語言提供的軟體更新,以及語言中性的更新。
使用主控台中顯示的語言格式。 例如:
English
Hungarian
Chinese (Simplified, PRC)
字串陣列的格式為: "English","Hungarian","Chinese (Simplified, PRC)"
提示
如果您在 Windows 具有當地語系化 UI 的電腦上執行此 Cmdlet,語言名稱可能會不同。 例如,英文版的 Windows 使用「丹麥文」,但丹麥文版本的 Windows 使用 「Dansk」。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
指定您網路中電腦可以下載軟體更新的位置。 若要使用此位置,請為-DownloadFromInternet參數指定 的 $False
值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MicrosoftAsVendor
指出規則是否只包含以 Microsoft 作為廠商的更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定軟體更新的自動部署規則名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnRemote
指出是否不允許在遠端系統上安裝更新。
- 如果您指定 的值為 ,如果用戶端位於緩慢或不可靠的網路界限內,或用戶端使用內容的
$True
後援來源位置,則Configuration Manager不會安裝軟體更新。 - 如果您指定 的
$False
值,則會繼續安裝。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnUnprotected
指出是否不允許在未受保護的系統上安裝更新。
- 如果您指定 的值為
$True
,如果任何慣用發佈點上都無法使用軟體更新,Configuration Manager不會下載並安裝軟體更新。 - 如果您指定 的
$False
值,則會繼續安裝。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-O365LanguageSelection
使用此參數來設定Office 365用戶端更新語言選取專案。 指定語言的字串陣列。 用戶端會下載以指定語言提供的軟體更新,以及語言中性的更新。
針對Windows Update語言選取專案,使用主控台中顯示的語言格式。 此格式與 LanguageSelection 參數的 相同。 例如:
English
Hungarian
Chinese (Simplified, PRC)
字串陣列的格式為: "English","Hungarian","Chinese (Simplified, PRC)"
提示
如果您在 Windows 具有當地語系化 UI 的電腦上執行此 Cmdlet,語言名稱可能會不同。 例如,英文版的 Windows 使用「丹麥文」,但丹麥文版本的 Windows 使用 「Dansk」。
您目前無法使用此參數來指定Configuration Manager主控台中可用的所有語言。 例如,您無法指定「愛爾蘭 (愛爾蘭) 」或「 (愛爾蘭) 」。
從 2103 版開始,您必須指定具有國家/地區名稱的語言。 這項變更會將此參數與 Configuration Manager 主控台中的選項對齊。 例如,-O365LanguageSelection "English (United States)"
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Product
指定軟體更新的準則陣列做為字串。 此規則會將符合指定準則的產品軟體更新新增至軟體更新群組。
從 2107 版開始,當有多個具有相同名稱的產品時,它會選取所有產品。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Required
指定軟體更新的準則陣列做為字串。 此規則會將符合指定準則的必要專案所識別的軟體更新新增至軟體更新群組。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
使用此參數可在 ADR 部署設定的 [ 使用者體驗 ] 頁面上設定下列選項: 如果此部署中的任何更新需要系統重新開機,請在重新開機之後執行更新部署評估週期。
Type: | Boolean |
Aliases: | RunEvaluationAfterRestart |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunType
指定月臺評估 ADR 時的週期性排程。
如果您指定 RunTheRuleOnSchedule
,請使用 -Schedule 參數來指定排程。
Type: | RunType |
Accepted values: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
指定部署的排程物件。 若要取得排程物件,請使用 New-CMSchedule Cmdlet。 如果您為-RunType參數指定 的 RunTheRuleOnSchedule
值,請指定此參數的排程。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
指出是否要在部署開始之前將喚醒封包傳送至電腦。
- 如果此值為
$True
,Configuration Manager會喚醒電腦進入睡眠狀態。 - 如果此值為
$False
,則不會喚醒電腦進入睡眠狀態。
若要讓電腦喚醒,您必須先設定網路喚醒。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Severity
指定軟體更新的嚴重性層級陣列。 此規則會將指定嚴重性類型的軟體更新新增至軟體更新群組。
Type: | SeverityType[] |
Aliases: | Severities |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftDeadlineEnabled
使用此參數可在 ADR 部署設定的 [ 部署排程 ] 頁面上設定下列選項: 根據使用者喜好設定延遲強制執行此部署,最多可達用戶端設定中定義的寬限期。
Type: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessPercentage
以 0 到 99 的整數指定用戶端合規性的百分比。 如果合規性低於此百分比,Configuration Manager會產生選擇性警示。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Superseded
指出規則是否新增其他更新取代的更新。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartServer
指出是否要隱藏伺服器的必要更新。 某些軟體更新需要系統重新開機才能完成安裝程式。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartWorkstation
指出是否要隱藏工作站的必要更新。 某些軟體更新需要系統重新開機才能完成安裝程式。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Title
指定軟體更新的準則陣列做為字串。 此規則會將標題符合指定準則的軟體更新新增至軟體更新群組。
Type: | String[] |
Aliases: | Titles |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateClassification
指定軟體更新的準則陣列做為字串。 此規則會將具有符合指定準則之更新分類的軟體更新新增至軟體更新群組。
Type: | String[] |
Aliases: | UpdateClassifications |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateDeploymentWaitDay
Type: | Int32 |
Aliases: | UpdateDeploymentWaitDays |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateDescription
指定軟體更新的準則陣列做為字串。 此規則會將具有符合指定準則之更新描述的軟體更新新增至軟體更新群組。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseBranchCache
指出是否要針對此更新部署使用 Windows BranchCache。 如果您指定 的 $True
值,用戶端會在相同的子網上共用內容。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
指定使用者通知的類型。
DisplayAll
:在軟體中心顯示並顯示所有通知。DisplaySoftwareCenterOnly
:顯示在軟體中心,且只會顯示電腦重新開機的通知。HideAll
:在軟體中心和所有通知中隱藏。
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
指出是否要使用國際標準時間 (UTC) 。
- 如果此值為
$True
,Configuration Manager針對此部署使用 UTC。 - 如果此值為
$False
,Configuration Manager使用當地時間。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Vendor
Type: | String[] |
Aliases: | Vendors |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLevel
指定您希望用戶端針對此規則所建立之部署報告的詳細資料層級。
Type: | VerboseLevelType |
Accepted values: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
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 |
-WriteFilterHandling
指出是否啟用內嵌裝置的寫入篩選。
- 針對 的
$True
值,裝置會在維護期間認可變更。 此動作需要重新開機。 - 針對 的
$False
值,裝置會將變更儲存在重迭中,並在稍後認可。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject
備註
如需此傳回物件及其屬性的詳細資訊,請 參閱SMS_AutoDeployment伺服器 WMI 類別。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應