Set-CMClientSetting
更改 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
指定防火墙异常配置文件。
有效值包含:
类型: | 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
指定要允许的按流量计费的网络使用情况的类型。
有效值包含:
类型: | 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 脚本。
有效值包括
默认值为 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 中启动的远程协助会话的访问权限级别。
客户端计算机上的用户始终授予远程协助会话的发生权限。
有效值包含:
类型: | 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 列在 相关链接中。