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 参数指定现有更新组或为新更新组分配名称。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AlertTime

指定与更新部署截止时间相差的整数偏移量。 规则使用此值来指定规则何时生成警报。 使用 -AlertTimeUnit 参数指定时间单位。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AlertTimeUnit

指定 -AlertTime 参数的时间单位。

类型:TimeUnitType
接受的值:Hours, Days, Weeks, Months
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AllowRestart

指示如果更新部署发生在维护时段外,是否允许计算机重启。 维护时段是用于计算机维护和更新的指定时间段。

  • 如果此值为 $True,则 Configuration Manager 会在必要时重启计算机以完成更新。
  • 如果此值为 $False,则 Configuration Manager 不会重新启动计算机。
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AllowSoftwareInstallationOutsideMaintenanceWindow

指示是否进行更新部署,即使计划于维护时段之外也是如此。 维护时段是用于计算机维护和更新的指定时间段。

  • 如果此值为 $True,则 Configuration Manager 会部署更新,即使计划的时间超出服务时段。
  • 如果此值为 $False,则 Configuration Manager 不会在服务窗口外部署更新。 它会等待,直到可以在服务窗口中部署。
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AllowUseMeteredNetwork

指示是否允许客户端在截止时间后通过按流量计费的 Internet 连接下载内容,这可能会产生额外的费用。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Architecture

使用此参数可在 ADR 属性的“软件更新”页上设置 “体系结构 ”属性筛选器。

类型:ArchitectureType[]
别名:Architectures
接受的值:Arm64, Itanium, X64, X86
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ArticleId

指定软件更新的条件数组(作为字符串)。 规则将具有符合指定条件的文章 ID 的软件更新添加到软件更新组。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AvailableImmediately

指示此规则在更新可用后是否立即部署更新。 如果选择值 $False,请使用 -AvailableTime-AvailableTimeUnit 参数指定规则运行后部署更新的时间长度。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AvailableTime

将时间段指定为整数。 Configuration Manager 会在规则运行很久后部署更新。 使用 -AvailableTimeUnit 参数指定时间单位。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AvailableTimeUnit

指定 -AvailableTime 参数的时间单位。

类型:TimeUnitType
接受的值:Hours, Days, Weeks, Months
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BulletinId

指定软件更新的条件数组(作为字符串)。 规则将具有符合指定条件的公告 ID 的软件更新添加到软件更新组。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CMTag

此属性保留供将来使用。

类型:CMTagTypes[]
接受的值:None, UUP
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Collection

指定集合对象作为自动部署规则的目标。

类型:IResultObject
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-CollectionId

指定集合 ID 作为自动部署规则的目标。

类型: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

-ContentSize

使用此参数可在 ADR 属性的“软件更新”页上设置 内容大小 (KB) 属性筛选器。

类型:String[]
别名:ContentSizes
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CustomSeverity

指定软件更新的自定义严重性类型的数组。 该规则将具有符合指定条件的自定义严重级别的软件更新添加到软件更新组。

类型:SeverityType[]
接受的值:None, Low, Moderate, Important, Critical
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DateReleasedOrRevised

指定软件更新的发布或修订日期。 规则将具有符合指定条件的软件更新添加到软件更新组。

类型:DateReleasedOrRevisedType
接受的值: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
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeadlineImmediately

指示是否在规则运行后立即强制实施截止时间。 如果指定值 $False,请使用 -DeadlineTime-DeadlineTimeUnit 参数指定规则运行后多长时间来设置截止时间。 在截止时间之后,Configuration Manager 将安装所需的更新。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeadlineTime

将时间段指定为整数。 更新的最后期限是规则运行后的很久。 使用 -DeadlineTimeUnit 参数指定时间单位。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeadlineTimeUnit

指定 -DeadlineTime 参数的时间单位。

类型:TimeUnitType
接受的值:Hours, Days, Weeks, Months
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeploymentPackage

使用此参数可指定用于此自动部署规则的部署包的对象。 若要不需要包,请将 值设置为 $null

类型:IResultObject
别名:InputObject
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DeploymentPackageName

指定要用于此自动部署规则的部署包的名称。 若要不需要包,请将 值设置为 $null

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeploymentRing

类型:DeploymentRing
接受的值:CB, Release, BusinessMainstream, Cbb, Ltsb
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DeployWithoutLicense

指示规则是否在没有许可证的情况下部署更新。

  • 如果将 值 $True指定为 ,则 Configuration Manager 将部署此规则的所有更新并批准任何许可协议。
  • 如果此值为 $False,则 Configuration Manager 仅部署不包含许可证或已批准许可协议的更新。
类型:Boolean
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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DownloadFromInternet

指示计算机是否从 Internet 下载软件更新。 如果指定 值 $False,则指定计算机可以使用 -Location 参数下载更新的备用位置。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DownloadFromMicrosoftUpdate

指示计算机是否从 Microsoft更新下载内容,前提是该内容在远程分发点的首选分发点上不可用。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Enable

指定在创建自动部署规则后是否启用该规则。

类型:Boolean
别名:Enabled, EnableDeployment
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnabledAfterCreate

指示在此规则运行后是否为关联的软件更新组启用软件部署。 如果此值为 $False,请手动部署软件更新组。

类型:Boolean
别名:EnableAfterCreate
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-GenerateFailureAlert

如果规则失败,请创建 Configuration Manager 警报。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-GenerateOperationManagerAlert

指示是否在软件更新期间生成 Operations Manager 警报。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-GenerateSuccessAlert

指示是否生成成功部署的警报。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IsServicingPlan

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Language

为软件更新指定语言条件的字符串数组。 规则将具有符合指定条件的语言的软件更新添加到软件更新组。

使用控制台中显示的语言格式。 例如:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

字符串数组的格式为: "English","Hungarian","Chinese (Simplified, PRC)"

提示

如果在 Windows 具有本地化 UI 的计算机上运行此 cmdlet,则语言名称可能不同。 例如,Windows 的英语版本使用“丹麦语”,但丹麦版本的 Windows 使用“Dansk”。

类型:String[]
别名:Languages, UpdateLocales, UpdateLocale
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LanguageSelection

指定语言的字符串数组。 客户端下载以指定语言提供的软件更新和非特定语言更新。

使用控制台中显示的语言格式。 例如:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

字符串数组的格式为: "English","Hungarian","Chinese (Simplified, PRC)"

提示

如果在 Windows 具有本地化 UI 的计算机上运行此 cmdlet,则语言名称可能不同。 例如,Windows 的英语版本使用“丹麦语”,但丹麦版本的 Windows 使用“Dansk”。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

指定网络中计算机可以下载软件更新的位置。 若要使用此位置,请为 -DownloadFromInternet 参数指定值$False

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MicrosoftAsVendor

指示规则是否仅包含Microsoft作为供应商的更新。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定软件更新的自动部署规则的名称。

类型: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

-O365LanguageSelection

使用此参数设置 Office 365 客户端更新 语言选择。 指定语言的字符串数组。 客户端下载以指定语言提供的软件更新和非特定语言更新。

使用控制台中显示的语言格式进行 Windows 更新 语言选择。 此格式与 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)"

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Product

指定软件更新的条件数组(作为字符串)。 规则将符合指定条件的产品的软件更新添加到软件更新组。

从版本 2107 开始,当有多个具有相同名称的产品时,它会选择所有这些产品。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Required

指定软件更新的条件数组(作为字符串)。 该规则将根据需要标识的、符合指定条件的软件更新添加到软件更新组。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RequirePostRebootFullScan

使用此参数可在 ADR 部署设置的 “用户体验 ”页上设置以下选项: 如果此部署中的任何更新需要系统重启,请在重启后运行更新部署评估周期

类型:Boolean
别名:RunEvaluationAfterRestart
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunType

指定站点评估 ADR 时的定期计划。

如果指定 RunTheRuleOnSchedule,请使用 -Schedule 参数指定计划。

类型:RunType
接受的值:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Schedule

指定部署的计划对象。 若要获取计划对象,请使用 New-CMSchedule cmdlet。 如果为 -RunType 参数指定 值,RunTheRuleOnSchedule请为此参数指定计划。

类型:IResultObject
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SendWakeupPacket

指示是否在部署开始前将唤醒数据包发送到计算机。

  • 如果此值为 $True,则 Configuration Manager 将计算机从睡眠状态唤醒。
  • 如果此值为 $False,则不会将计算机从睡眠状态唤醒。

要唤醒计算机,必须首先配置 LAN 唤醒。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Severity

指定软件更新的严重性级别的数组。 规则将指定严重性类型的软件更新添加到软件更新组。

类型:SeverityType[]
别名:Severities
接受的值:None, Low, Moderate, Important, Critical
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SoftDeadlineEnabled

使用此参数可在 ADR 部署设置的“ 部署计划 ”页上设置以下选项: 根据用户首选项延迟此部署的强制,最长为客户端设置中定义的宽限期

类型:Boolean
别名:DelayEnforcementAndUpToGracePeriod
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SuccessPercentage

将客户端符合性百分比指定为 0 到 99 的整数。 如果符合性低于此百分比,Configuration Manager 将生成可选警报。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Superseded

指示规则是否添加被其他更新取代的更新。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SuppressRestartServer

指示是否取消对服务器进行所需的更新。 某些软件更新需要重启系统才能完成安装过程。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SuppressRestartWorkstation

指示是否取消对工作站进行所需的更新。 某些软件更新需要重启系统才能完成安装过程。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Title

指定软件更新的条件数组(作为字符串)。 规则将具有符合指定条件的游戏的软件更新添加到软件更新组。

类型:String[]
别名:Titles
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateClassification

指定软件更新的条件数组(作为字符串)。 规则将具有符合指定条件的更新分类的软件更新添加到软件更新组。

类型:String[]
别名:UpdateClassifications
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateDeploymentWaitDay

类型:Int32
别名:UpdateDeploymentWaitDays
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateDescription

指定软件更新的条件数组(作为字符串)。 规则将具有符合指定条件的更新说明的软件更新添加到软件更新组。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseBranchCache

指示是否对此更新部署使用 Windows BranchCache。 如果指定值 $True,则客户端在同一子网上共享内容。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UserNotification

指定用户通知的类型。

  • DisplayAll:在软件中心显示并显示所有通知。
  • DisplaySoftwareCenterOnly:在软件中心显示,仅显示计算机重启通知。
  • HideAll:在软件中心和所有通知中隐藏。
类型:UserNotificationType
接受的值:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UseUtc

指示是否使用协调世界时 (UTC) 。

  • 如果此值为 $True,则 Configuration Manager 对此部署使用 UTC。
  • 如果此值为 $False,则 Configuration Manager 使用本地时间。
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Vendor

类型:String[]
别名:Vendors
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VerboseLevel

指定希望客户端针对此规则创建的部署报告的详细信息级别。

类型:VerboseLevelType
接受的值:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-WriteFilterHandling

指示是否为嵌入式设备启用写入筛选器。

  • 对于 值 $True,设备在维护时段内提交更改。 此操作需要重启。
  • 如果值为 $False,设备会将更改保存在覆盖中,并在以后提交更改。
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

有关此返回对象及其属性的详细信息,请参阅 SMS_AutoDeployment服务器 WMI 类