Set-CMClientSetting

参考

模块:: ConfigurationManager

更改 Configuration Manager 设备和用户的客户端设置。

语法

Set-CMClientSetting
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Priority <PriorityChangeType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-AccessLevel <AccessLevelType>]
   [-AllowClientChange <Boolean>]
   [-AllowPermittedViewer <Boolean>]
   [-AllowRemoteControlOfUnattendedComputer <Boolean>]
   [-AudibleSignal <AudibleSignalType>]
   [-FirewallExceptionProfile <FirewallExceptionProfileType[]>]
   [-GrantRemoteControlPermissionToLocalAdministrator <Boolean>]
   [-ManageRemoteDesktopSetting <Boolean>]
   [-ManageSolicitedRemoteAssistance <Boolean>]
   [-ManageUnsolicitedRemoteAssistance <Boolean>]
   -Name <String>
   [-PassThru]
   [-PermittedViewer <String[]>]
   [-PromptUserForPermission <Boolean>]
   [-RemoteAssistanceAccessLevel <RemoteAssistanceAccessLevelType>]
   [-RemoteControl]
   [-RequireAuthentication <Boolean>]
   [-ShowNotificationIconOnTaskbar <Boolean>]
   [-ShowSessionConnectionBar <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-AddPortalToTrustedSiteList <Boolean>]
   [-AllowPortalToHaveElevatedTrust <Boolean>]
   [-ApplicationCatalogWebsitePointServerName <String>]
   [-BrandingTitle <String>]
   [-ComputerAgent]
   [-DisplayNewProgramNotification <Boolean>]
   [-EnableThirdPartyOrchestration <EnableThirdPartyOrchestrationType>]
   [-FinalReminderMins <Int32>]
   [-InitialReminderHours <Int32>]
   [-InstallRestriction <InstallRestrictionType>]
   [-InterimReminderHours <Int32>]
   -Name <String>
   [-PassThru]
   [-PortalUrl <String>]
   [-PowerShellExecutionPolicy <PowerShellExecutionPolicyType>]
   [-SelectApplicationCatalogWebsitePoint <ApplicationCatalogWebsitePointType>]
   [-SuspendBitLocker <SuspendBitLockerType>]
   [-UseNewSoftwareCenter <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-AllowCloudDistributionPoint <Boolean>]
   [-CloudService]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-AllowUserAffinity <Boolean>]
   [-AutoApproveAffinity <Boolean>]
   [-LogOnThresholdMins <Int32>]
   -Name <String>
   [-PassThru]
   [-UsageThresholdDays <Int32>]
   [-UserDeviceAffinity]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-AllowUserToOptOutFromPowerPlan <Boolean>]
   [-Enable <Boolean>]
   [-EnableWakeupProxy <Boolean>]
   [-FirewallExceptionForWakeupProxy <WakeUpProxyFirewallExceptionTypes>]
   -Name <String>
   [-PassThru]
   [-PowerManagement]
   [-WakeOnLanPort <Int32>]
   [-WakeupProxyDirectAccessPrefix <String>]
   [-WakeupProxyPort <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-BatchingTimeout <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnforceMandatory <Boolean>]
   -Name <String>
   [-PassThru]
   [-ScanSchedule <IResultObject>]
   [-SoftwareUpdate]
   [-TimeUnit <BatchingTimeoutType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Bits]
   [-EnableBitsMaxBandwidth <Boolean>]
   [-EnableDownloadOffSchedule <Boolean>]
   [-MaxBandwidthBeginHr <Int32>]
   [-MaxBandwidthEndHr <Int32>]
   [-MaxTransferRateOffSchedule <Int32>]
   [-MaxTransferRateOnSchedule <Int32>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-ClientPolicy]
   [-EnableUserPolicy <Boolean>]
   [-EnableUserPolicyOnInternet <Boolean>]
   [-EnableUserPolicyOnTS <Boolean>]
   -Name <String>
   [-PassThru]
   [-PolicyPollingMins <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Compliance]
   [-EnableComplianceEvaluation <Boolean>]
   [-EnableUserDataAndProfile <Boolean>]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-ComputerRestart]
   -Name <String>
   [-PassThru]
   [-RebootLogoffNotificationCountdownMins <Int32>]
   [-RebootLogoffNotificationFinalWindowMins <Int32>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-NoRebootEnforcement <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-DisableFirstSignatureUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EndpointProtection]
   [-ForceRebootHr <Int32>]
   [-InstallEndpointProtectionClient <Boolean>]
   -Name <String>
   [-PassThru]
   [-RemoveThirdParty <Boolean>]
   [-SuppressReboot <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Enable <Boolean>]
   [-HardwareInventory]
   [-InventoryReportId <String>]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Enable <Boolean>]
   [-Enrollment]
   [-EnrollmentProfileName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Enable <Boolean>]
   [-ForceScan <Boolean>]
   -Name <String>
   [-NetworkAccessProtection]
   [-PassThru]
   [-Schedule <IResultObject>]
   [-UseUtcForEvaluationTime <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Enable <Boolean>]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-SoftwareMetering]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-Enable <Boolean>]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-SoftwareInventory]
   [-SoftwareInventoryFileDisplayName <String>]
   [-SoftwareInventoryFileInventoriedName <String>]
   [-SoftwareInventoryFileName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   [-MeteredNetwork]
   [-MeteredNetworkUsage <MeteredNetworkUsageType>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   -Name <String>
   [-PassThru]
   [-ReportingCycleMins <Int32>]
   [-StateMessage]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSetting
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-SoftwareDeployment]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMClientSetting cmdlet 更改 Configuration Manager 设备和用户的客户端设置。 Configuration Manager 为所有客户端设置提供默认值，但你可以使用此 cmdlet 修改设置对象。设置对象确定各个客户端的设置。有关详细信息，请参阅关于客户端设置。

重要

从版本 2010 开始，此 cmdlet 已弃用。使用特定于客户端设置组的其中一个 cmdlet，这些 cmdlet 列在相关链接中。

若要修改客户端设置，请按名称指定它。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。有关详细信息，请参阅入门。

示例

示例 1：重命名客户端设置

此命令重命名客户端设置对象。新名称为 “客户端设置 TSQA”。该命令还会添加客户端设置对象的说明。

Set-CMClientSetting -Name "Client Settings Main" -Description "Client settings for TSQA office site." -NewName "Client Settings TSQA"

示例 2：配置电源管理

此命令允许用户选择退出电源计划，并使用名为 TSQA02 的设置对客户端禁用电源管理。

Set-CMClientSetting -Name "TSQA02" -AllowUserToOptOutFromPowerPlan $True -EnablePowerManagement $False

示例 3：设置状态消息报告周期值

此命令将状态消息报告周期值设置为 10 分钟。

Set-CMClientSetting -Name "TSQA02" -StateMessagingReportingCycleMinutes 10

示例 4：配置用户相关性

此命令为名为 TSQA03 的客户端设置配置用户关联设置：

它禁用相关性的自动审批。
它将 UserAffinityLogOnThresholdMinutes 参数设置为 2800 分钟， 并将 UserAffinityUsageThresholdDays 参数设置为 20 天。如果用户在 20 天内使用设备 2800 分钟，Configuration Manager 将创建用户设备相关性。

Set-CMClientSetting -Name "TSQA03" -AutoApproveAffinity $False -UserAffinityLogOnThresholdMinutes 2800 -UserAffinityUsageThresholdDays 20

示例 5：允许用户关联

此命令将名为 TSQA04 的客户端设置更改为让客户端根据使用情况数据自动配置用户设备相关性。

Set-CMClientSetting -Name "TSQA04" -AllowUserAffinity $True

示例 6：为客户端设置带宽

此命令更改名为 TSQA05 的客户端设置对象的设置：

它为 BITS 传输启用最大带宽，并启用计划外下载。
它还指定从和到的最大带宽值和计划的最大传输速率的值。

Set-CMClientSetting -Name "TSQA05" -EnableBITSMaxBandwidth $True EnableDownloadOffSchedule $True -MaxBandwidthValidFrom 8 -MaxBandwidthValidTo 15 -MaxTransferRateOnSchedule 1500

示例 7：在 Internet 上配置用户策略

此命令更改名为 TSQA06 的客户端设置对象的设置：

在 Internet 上启用用户策略
启用用户策略轮询
设置策略轮询间隔

Set-CMClientSetting -Name "TSQA06" -EnableUserPolicyOnInternet $True -EnableUserPolicyPolling $False -EnableUserPolicyOnInternet $True -PolicyPollingInterval 50

示例 8：禁用符合性评估

此命令对名为 TSQA07 的设置禁用符合性评估。

Set-CMClientSetting -Name "TSQA07" -EnableComplianceEvaluation $False

示例 9：设置计算机代理设置

此命令更改名为 TSQA09 的客户端设置对象的设置：

指定一个门户，并将该门户添加到受信任的站点列表，并允许其具有提升的信任。
指定品牌标题 Contoso IT。
启用第三方业务流程。
设置最终提醒和初始提醒间隔。
指定只有管理员才能安装软件，选择“绕过”作为 Windows PowerShell 执行策略，并挂起 BitLocker PIN 要求。

Set-CMClientSetting -Name "TSQA09" -AddPortalToTrustedSiteList $True -AllowPortalToHaveElevatedTrust $True -BrandingTitle "Contoso IT" -EnableThirdPartyOrchestration Yes -FinalReminderMinutesInterval 52 -InitialReminderHoursInterval 6 -InstallRestriction OnlyAdministrators -PortalUrl "https://NewInstall.Contoso.com" -PowerShellExecutionPolicy Bypass -SuspendBitLocker Always

示例 10：配置重启设置

此命令为名为 TSQA11 的客户端设置对象设置重启注销通知倒计时持续时间和注销通知最终时段持续时间。

Set-CMClientSetting -Name "TSQA11" -RebootLogoffNotificationCountdownDuration 12 -RebootLogoffNotificationFinalWindowMinutes 80

示例 11：配置按流量计费的网络使用情况

此命令限制名为 TSQA21 的客户端设置对象的按流量计费的网络使用情况。

Set-CMClientSetting -Name "TSQA21" -MeteredNetworkUsage Limit

参数

-AccessLevel

指定允许的远程控制访问级别。有效值包含:

完全控制
NoAccess
None
ViewOnly

类型:	AccessLevelType
接受的值:	NoAccess, ViewOnly, FullControl
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddPortalToTrustedSiteList

请勿使用此参数。不再支持应用程序目录。

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

-AllowClientChange

指示用户是否可以在软件中心更改策略或通知设置。

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

-AllowCloudDistributionPoint

指示设备或用户是否可以从基于云的分发点访问内容。

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

-AllowPermittedViewer

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

-AllowPortalToHaveElevatedTrust

指示是否允许门户具有提升的信任。

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

-AllowRemoteControlOfUnattendedComputer

指示是否允许远程控制未登录该计算机的用户的计算机。

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

-AllowUserAffinity

指示用户是否可以定义其主设备。

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

-AllowUserToOptOutFromPowerPlan

指示是否允许用户从电源管理设置中排除设备。

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

-ApplicationCatalogWebsitePointServerName

请勿使用此参数。不再支持应用程序目录。

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

-AudibleSignal

指定客户端计算机在远程控制下播放的声音类型。此设置不适用于远程协助。有效值包含:

None
PlayNoSound
PlaySoundAtBeginAndEnd
PlaySoundRepeatedly

类型:	AudibleSignalType
接受的值:	PlayNoSound, PlaySoundAtBeginAndEnd, PlaySoundRepeatedly
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AutoApproveAffinity

指示客户端是否根据使用情况数据自动配置用户设备相关性。

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

-BatchingTimeout

以整数的形式指定超时值。使用 TimeUnit 参数将值指定为 Hours 或 Days。更新截止时间过后，Configuration Manager 将部署此时间段内挂起的所有更新。

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

-Bits

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

-BrandingTitle

指定 Configuration Manager 品牌标题。此品牌信息可帮助用户将 Configuration Manager 标识为受信任的源。

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

-ClientPolicy

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

-CloudService

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

-Compliance

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

-ComputerAgent

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

-ComputerRestart

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DeploymentEvaluationSchedule

将部署评估计划指定为计划对象。若要获取计划对象，请使用 New-CMSchedule cmdlet。

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

-Description

指定客户端设置的说明。

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

-DisableFirstSignatureUpdate

指示是否从远程源禁用客户端上的第一个签名更新。

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

-DisableWildcardHandling

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

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

-DisplayNewProgramNotification

指示 Configuration Manager 是否显示有关软件可用性或软件安装的用户通知。如果此参数的值为 $False，则用户只看到重启通知。

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

-Enable

指示是否启用客户端设置。

类型:	Boolean
别名:	EnableEndpointProtection, EnablePowerManagement, EnableHardwareInventory, EnableDeviceEnrollment, EnableNetworkAccessProtection, EnableSoftwareMetering, EnableSoftwareUpdatesOnClient, EnableSoftwareInventory
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableBitsMaxBandwidth

指定是否为后台智能传输服务启用最大带宽 (BITS) 后台传输。

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

-EnableComplianceEvaluation

指示是否为此客户端启用符合性评估。

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

-EnableDownloadOffSchedule

指定是否允许在限制窗口外下载 BITS。

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

-EnableThirdPartyOrchestration

指定软件更新和软件分发代理是否等待第三方软件安装更新和应用程序。

有效值为：“是”和“否”。

类型:	EnableThirdPartyOrchestrationType
接受的值:	No, Yes
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableUserDataAndProfile

指示是否启用用户数据和配置文件设置。

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

-EnableUserPolicy

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

-EnableUserPolicyOnInternet

指示用户在登录到 Internet 上的计算机时是否收到用户策略。若要让用户接收用户策略，必须启用用户轮询。可以使用 EnableUserPolicyPolling 参数启用用户轮询。基于 Internet 的管理点必须对用户进行身份验证。

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

-EnableUserPolicyOnTS

使用此参数启用或禁用客户端设置“ 为多个用户会话启用用户策略”。

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

-EnableWakeupProxy

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

-EndpointProtection

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

-EnforceMandatory

指示是否强制执行在指定时间段内具有截止时间的所有强制软件更新部署。

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

-Enrollment

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

-EnrollmentProfileName

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

-FinalReminderMins

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

-FirewallExceptionForWakeupProxy

类型:	WakeUpProxyFirewallExceptionTypes
别名:	WindowsFirewallExceptionsForWakeUpProxy
接受的值:	None, Public, Private, Domain
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FirewallExceptionProfile

指定防火墙异常配置文件。有效值包含:

Disabled
Domain
私人
公共

类型:	FirewallExceptionProfileType[]
接受的值:	Disabled, Public, Private, Domain
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceRebootHr

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

-ForceScan

指示是否启用强制扫描。

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

-ForceWildcardHandling

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

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

-GrantRemoteControlPermissionToLocalAdministrator

指示启动远程控制连接的服务器上的本地管理员是否可以建立到此客户端的远程控制会话。

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

-HardwareInventory

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

-InitialReminderHours

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

-InstallEndpointProtectionClient

指示是否在此客户端上安装并启用 Endpoint Protection 客户端（如果尚未安装）。

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

-InstallRestriction

指定哪些用户可以启动安装。有效值包含:

AllUsers
NoUsers
OnlyAdministrators
OnlyAdministratorsAndPrimaryUsers

类型:	InstallRestrictionType
接受的值:	AllUsers, OnlyAdministrators, OnlyAdministratorsAndPrimaryUsers, NoUsers
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InterimReminderHours

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

-InventoryReportId

指定清单报表 ID。

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

-LogOnThresholdMins

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

-ManageRemoteDesktopSetting

指示是否允许 Configuration Manager 管理计算机的远程桌面会话。

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

-ManageSolicitedRemoteAssistance

指示是否允许 Configuration Manager 管理请求的远程协助会话。

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

-ManageUnsolicitedRemoteAssistance

指示是否允许 Configuration Manager 管理未经请求的远程协助会话。

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

-MaxBandwidthBeginHr

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

-MaxBandwidthEndHr

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

-MaxTransferRateOffSchedule

指定计划外的最大传输速率的整数值。

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

-MaxTransferRateOnSchedule

指定计划上的最大传输速率的整数值。

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

-MeteredNetwork

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

-MeteredNetworkUsage

指定要允许的按流量计费的网络使用情况的类型。有效值包含:

允许
阻止
限制
None

类型:	MeteredNetworkUsageType
接受的值:	None, Allow, Limit, Block
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定客户端设置的名称。

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

-NetworkAccessProtection

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

-NewName

指定客户端设置的新名称。

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

-NoRebootEnforcement

适用于版本 2006 及更高版本。配置客户端设置 Configuration Manager 可以强制重启设备 ，以防止设备在部署需要时自动重启。默认情况下，Configuration Manager 仍可以强制设备重启。有关详细信息，请参阅设备重启通知。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。默认情况下，此 cmdlet 可能不会生成任何输出。

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

-PermittedViewer

指定可以与客户端计算机建立远程控制会话的用户的名称数组。

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

-PolicyPollingMins

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

-PortalUrl

为客户端的门户指定链接（作为 URL）。

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

-PowerManagement

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

-PowerShellExecutionPolicy

指定 Configuration Manager 如何在远程计算机上运行 Windows PowerShell 脚本。有效值包括

AllSigned
旁路
受限

默认值为 Restricted。

选择“受限”时，Configuration Manager 客户端使用客户端计算机上的当前 Windows PowerShell 配置，以确定未签名脚本是否运行。

类型:	PowerShellExecutionPolicyType
接受的值:	AllSigned, Bypass, Restricted
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Priority

指定客户端设置的优先级更改。有效值为：减少和增加。

类型:	PriorityChangeType
接受的值:	Increase, Decrease
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PromptUserForPermission

指示客户端计算机是否在允许远程控制会话之前显示请求用户权限的消息。

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

-RebootLogoffNotificationCountdownMins

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

-RebootLogoffNotificationFinalWindowMins

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

-RemoteAssistanceAccessLevel

指定要分配给 Configuration Manager 中启动的远程协助会话的访问权限级别。客户端计算机上的用户始终授予远程协助会话的发生权限。有效值包含:

完全控制
None
RemoteViewing

类型:	RemoteAssistanceAccessLevelType
接受的值:	None, RemoteViewing, FullControl
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoteControl

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

-RemoveThirdParty

指示是否删除第三方。

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

-ReplaceToastNotificationWithDialog

指定在部署需要重启时是否将 toast 通知替换为更具侵入性的对话框窗口。它是可选参数，默认情况下为 false。

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

-ReportingCycleMins

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

-RequireAuthentication

指示是否使用网络级身份验证与客户端计算机建立远程桌面连接。

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

-ScanSchedule

将扫描计划指定为计划对象。若要获取计划对象，请使用 New-CMSchedule cmdlet。

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

-Schedule

指定 CMSchedule 对象。若要创建 CMSchedule 对象，请使用 New-CMSchedule cmdlet。

类型:	IResultObject
别名:	InventorySchedule, NapEvaluationSchedule, EvaluationSchedule, DataCollectionSchedule, SoftwareInventorySchedule
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SelectApplicationCatalogWebsitePoint

请勿使用此参数。不再支持应用程序目录。

类型:	ApplicationCatalogWebsitePointType
接受的值:	Fqdn, AutoDetect, NetBios
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ShowNotificationIconOnTaskbar

指示是否在客户端计算机的任务栏上显示图标以指示活动的远程控制会话。

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

-ShowSessionConnectionBar

指示是否在客户端计算机上显示高可见性会话连接栏以指定活动的远程控制会话。

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

-SoftwareDeployment

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

-SoftwareInventory

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

-SoftwareInventoryFileDisplayName

指定要用于代替 SoftwareInventoryFileInventoriedName 参数指定的清单名称的显示名称。通过此参数，可以标准化不同文件标头中不同软件名称的清单信息。

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

-SoftwareInventoryFileInventoriedName

指定列出清单的制造商或产品名称。在软件清单期间，Configuration Manager 从客户端设备上的标头信息获取清单名称。

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

-SoftwareInventoryFileName

指定要在清点期间收集的文件的名称。可以使用通配符 (*) 来表示任何文本字符串，使用问号 ( ) 表示任何单个字符。

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

-SoftwareMetering

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

-SoftwareUpdate

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

-StateMessage

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

-SuppressReboot

指示在安装 System Center 2016 Endpoint Protection 客户端后是否绕过所需的计算机重启。

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

-SuspendBitLocker

指定在软件安装后计算机重启时是否绕过所需的 BitLocker 驱动器加密 PIN 条目。仅当 Configuration Manager 启动重启时，此设置才适用。有效值包含:

总是。 Configuration Manager 暂时挂起输入 PIN 的 BitLocker 要求。
从不。 Configuration Manager 在安装需要重启的软件后，不会暂停 BitLocker 要求，使其在下一次计算机启动时输入 PIN。

如果选择“从不”，则在用户输入 PIN 以完成标准启动过程之前，软件安装无法完成。

类型:	SuspendBitLockerType
接受的值:	Never, Always
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeUnit

指定 BatchingTimeout 参数中指定的值的单位。有效值为：小时和天。

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

-UsageThresholdDays

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

-UseNewSoftwareCenter

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

-UserDeviceAffinity

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

-UseUtcForEvaluationTime

指示是否使用协调世界时 (UTC) （也称为格林威治平均时间）来配置定期间隔。如果指定$False，Configuration Manager 将使用本地时间。

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

-WakeOnLanPort

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

-WakeupProxyDirectAccessPrefix

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

-WakeupProxyPort

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

-WhatIf

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

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

输入

None

输出

System.Object

备注

从版本 2010 开始，此 cmdlet 已弃用。使用特定于客户端设置组的其中一个 cmdlet，这些 cmdlet 列在相关链接中。

反馈

此页面是否有帮助？