New-CMSoftwareUpdateAutoDeploymentRule
为软件更新 (ADR) 创建自动部署规则。
语法
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>] 说明
New-CMSoftwareUpdateAutoDeploymentRule cmdlet (ADR) 软件更新创建自动部署规则。 规则运行时，Configuration Manager将符合规则条件的更新添加到软件更新组。 Configuration Manager服务器下载内容文件并将其复制到分发点，然后更新客户端计算机。 有关详细信息，请参阅 自动部署软件更新。
注意
从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建基本 ADR
此命令为名为 Desktops 的集合和名为 Updates123 的部署包创建名为 DeploymentRule07 的部署规则。 规则部署项目 ID 包含 117 的更新。
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"示例 2：创建使用计划和其他属性的 ADR
此示例创建使用定义的计划的自动部署规则。 根据计划进行部署。
第一个命令创建星期三的计划，并将 schedule 对象存储在 $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
指示是否允许客户端在截止时间后通过按流量计费的 Internet 连接下载内容，这可能会产生额外的费用。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Architecture
使用此参数在 ADR 属性的“软件汇报”页上设置体系结构属性筛选器。
| 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
指定软件更新的条件数组（作为字符串）。 规则将具有符合指定条件的文章 ID 的软件更新添加到软件更新组。
| 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
指定软件更新的条件数组（作为字符串）。 规则将具有符合指定条件的公告 ID 的软件更新添加到软件更新组。
| 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
指定集合 ID 作为自动部署规则的目标。
| 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
指示计算机是否从 Internet 下载软件更新。 如果指定 值 $False，则指定计算机可以使用 -Location 参数下载更新的备用位置。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DownloadFromMicrosoftUpdate
指示如果内容在远程分发点的首选分发点上不可用，计算机是否从 Microsoft 更新下载内容。
| 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
为软件更新指定语言条件的字符串数组。 规则将具有符合指定条件的语言的软件更新添加到软件更新组。
使用控制台中显示的语言格式。 例如：
EnglishHungarianChinese (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
指定语言的字符串数组。 客户端下载以指定语言提供的软件更新和非特定语言更新。
使用控制台中显示的语言格式。 例如：
EnglishHungarianChinese (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 更新语言。 此格式与 LanguageSelection 参数的 相同。 例如：
EnglishHungarianChinese (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，则不会将计算机从睡眠状态唤醒。
要唤醒计算机，必须首先配置 LAN 唤醒。
| 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 类。
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈