Set-CMClientSetting

Syntax

SetByName (Default)

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

SetRemoteToolsSettingsByName

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

SetComputerAgentSettingsByName

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

SetCloudSettingsByName

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

SetUserDeviceAffinitySettingsByName

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

SetPowerManagementSettingsByName

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

SetSoftwareUpdatesSettingsByName

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

SetBackgroundIntelligentTransferSettingsByName

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

SetClientPolicySettingsByName

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

SetComplianceSettingsByName

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

SetComputerRestartSettingsByName

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

SetEndpointProtectionSettingsByName

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

SetHardwareInventorySettingsByName

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

SetMobileDeviceSettingsByName

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

SetNetworkAccessProtectionSettingsByName

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

SetSoftwareMeteringSettingsByName

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

SetSoftwareInventorySettingsByName

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

SetMeteredNetworksSettingsByName

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

SetSecurityScopeByName

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

SetStateMessagingSettingsByName

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

SetSoftwareDeploymentSettingsByName

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

Description

Examples

Example 1: Rename a client setting

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

Example 2: Configure power management

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

Example 3: Set state messaging reporting cycle value

Set-CMClientSetting -Name "TSQA02" -StateMessagingReportingCycleMinutes 10

Example 4: Configure user affinity

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

Example 5: Allow user affinity

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

Example 6: Set bandwidth for client

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

Example 7: Configure user policies on the internet

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

Example 8: Disable compliance evaluation

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

Example 9: Set computer agent settings

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

Example 10: Configure restart settings

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

Example 11: Configure metered network usage

Set-CMClientSetting -Name "TSQA21" -MeteredNetworkUsage Limit

Parameters

-AccessLevel

Specifies a level of allowed remote control access. Valid values are:

• FullControl
• NoAccess
• None
• ViewOnly

Parameter properties

Parameter sets

-AddPortalToTrustedSiteList

Don't use this parameter. The application catalog is no longer supported.

Parameter properties

Parameter sets

-AllowClientChange

Indicates whether users can change policy or notification settings in Software Center.

Parameter properties

Parameter sets

-AllowCloudDistributionPoint

Indicates whether a device or user can access content from a cloud-based distribution point.

Parameter properties

Parameter sets

-AllowPermittedViewer

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-AllowPortalToHaveElevatedTrust

Indicates whether to allow a portal to have elevated trust.

Parameter properties

Parameter sets

-AllowRemoteControlOfUnattendedComputer

Indicates whether to allow remote control of a computer with no user logged onto that computer.

Parameter properties

Parameter sets

-AllowUserAffinity

Indicates whether users can define their primary devices.

Parameter properties

Parameter sets

-AllowUserToOptOutFromPowerPlan

Indicates whether to allow users to exclude a device from power management settings.

Parameter properties

Parameter sets

-ApplicationCatalogWebsitePointServerName

Don't use this parameter. The application catalog is no longer supported.

Parameter properties

Parameter sets

-AudibleSignal

Specifies what kind of sound a client computer plays while under remote control. This setting does not apply to remote assistance. Valid values are:

• None
• PlayNoSound
• PlaySoundAtBeginAndEnd
• PlaySoundRepeatedly

Parameter properties

Parameter sets

-AutoApproveAffinity

Indicates whether the client automatically configures user device affinity from usage data.

Parameter properties

Parameter sets

-BatchingTimeout

Specifies a timeout value, as an integer. Specify a value of Hours or Days by using the TimeUnit parameter. When an update deadline passes, Configuration Manager deploys all updates pending within this period.

Parameter properties

Parameter sets

-Bits

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-BrandingTitle

Specifies a Configuration Manager branding title. This branding information helps users identify Configuration Manager as a trusted source.

Parameter properties

Parameter sets

-ClientPolicy

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-CloudService

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-Compliance

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-ComputerAgent

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-ComputerRestart

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Parameter sets

-DeploymentEvaluationSchedule

Specifies a deployment evaluation schedule as a schedule object. To obtain a schedule object, use the New-CMSchedule cmdlet.

Parameter properties

Parameter sets

-Description

Specifies a description for client settings.

Parameter properties

Parameter sets

-DisableFirstSignatureUpdate

Indicates whether to disable the first signature update on client from a remote source.

Parameter properties

Parameter sets

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Parameter sets

-DisplayNewProgramNotification

Indicates whether Configuration Manager shows the user notifications for software availability or software installations. If this parameter has a value of $False, the user sees only restart notifications.

Parameter properties

Parameter sets

-Enable

Indicates whether to enable client settings.

Parameter properties

Parameter sets

-EnableBitsMaxBandwidth

Specifies whether to enable maximum bandwidth for Background Intelligent Transfer Service (BITS) background transfers.

Parameter properties

Parameter sets

-EnableComplianceEvaluation

Indicates whether to enable compliance evaluation for this client.

Parameter properties

Parameter sets

-EnableDownloadOffSchedule

Specifies whether allow BITS downloads outside of a throttling window.

Parameter properties

Parameter sets

-EnableThirdPartyOrchestration

Specifies whether Software Updates and Software Distribution agents wait for third-party software to install updates and applications.

Valid values are: Yes and No.

Parameter properties

Parameter sets

-EnableUserDataAndProfile

Indicates whether to enable user data and profile settings.

Parameter properties

Parameter sets

-EnableUserPolicy

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-EnableUserPolicyOnInternet

Indicates whether users receive a user policy when logged on to a computer on the Internet. In order for users to receive user policy, you must enable user polling. You can use the EnableUserPolicyPolling parameter to enable user polling. An Internet-based management point must authenticate the user.

Parameter properties

Parameter sets

-EnableUserPolicyOnTS

Use this parameter to enable or disable the client setting, Enable user policy for multiple user sessions.

Parameter properties

Parameter sets

-EnableWakeupProxy

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-EndpointProtection

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-EnforceMandatory

Indicates whether to enforce all mandatory software update deployments that have deadlines within a specified period of time.

Parameter properties

Parameter sets

-Enrollment

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-EnrollmentProfileName

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-FinalReminderMins

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-FirewallExceptionForWakeupProxy

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-FirewallExceptionProfile

Specifies a firewall exception profile. Valid values are:

• Disabled
• Domain
• Private
• Public

Parameter properties

Parameter sets

-ForceRebootHr

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-ForceScan

Indicates whether to enable force scan.

Parameter properties

Parameter sets

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Parameter sets

-GrantRemoteControlPermissionToLocalAdministrator

Indicates whether local administrators on the server initiating a remote control connection can establish remote control sessions to this client.

Parameter properties

Parameter sets

-HardwareInventory

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-InitialReminderHours

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-InstallEndpointProtectionClient

Indicates whether to install and enable the Endpoint Protection client on this client if it is not already installed.

Parameter properties

Parameter sets

-InstallRestriction

Specifies which users can initiate an install. Valid values are:

• AllUsers
• NoUsers
• OnlyAdministrators
• OnlyAdministratorsAndPrimaryUsers

Parameter properties

Parameter sets

-InterimReminderHours

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-InventoryReportId

Specifies an inventory report ID.

Parameter properties

Parameter sets

-LogOnThresholdMins

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-ManageRemoteDesktopSetting

Indicates whether to allow Configuration Manager to manage Remote Desktop sessions for computers.

Parameter properties

Parameter sets

-ManageSolicitedRemoteAssistance

Indicates whether to allow Configuration Manager to manage solicited remote assistance sessions.

Parameter properties

Parameter sets

-ManageUnsolicitedRemoteAssistance

Indicates whether to allow Configuration Manager to manage unsolicited remote assistance sessions.

Parameter properties

Parameter sets

-MaxBandwidthBeginHr

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-MaxBandwidthEndHr

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-MaxTransferRateOffSchedule

Specifies an integer value for maximum transfer rate off schedule.

Parameter properties

Parameter sets

-MaxTransferRateOnSchedule

Specifies an integer value for maximum transfer rate on schedule.

Parameter properties

Parameter sets

-MeteredNetwork

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-MeteredNetworkUsage

Specifies a type of metered network usage to allow. Valid values are:

• Allow
• Block
• Limit
• None

Parameter properties

Parameter sets

-Name

Specifies a name for a client setting.

Parameter properties

Parameter sets

-NetworkAccessProtection

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-NewName

Specifies a new name for a client setting.

Parameter properties

Parameter sets

-NoRebootEnforcement

Applies to version 2006 and later. Configure the client setting Configuration Manager can force a device to restart to prevent devices from automatically restarting when a deployment requires it. By default, Configuration Manager can still force devices to restart. For more information, see device restart notifications.

Parameter properties

Parameter sets

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

Parameter properties

Parameter sets

-PermittedViewer

Specifies an array of names of users who can establish remote control sessions to a client computer.

Parameter properties

Parameter sets

-PolicyPollingMins

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-PortalUrl

Specifies a link, as a URL, for a portal for a client.

Parameter properties

Parameter sets

-PowerManagement

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-PowerShellExecutionPolicy

Specifies how Configuration Manager runs Windows PowerShell scripts on remote computers. Valid values are

• AllSigned
• Bypass
• Restricted

The default value is Restricted.

When you select Restricted, the Configuration Manager client uses the current Windows PowerShell configuration on the client computer, which determines whether unsigned scripts run.

Parameter properties

Parameter sets

-Priority

Specifies a priority change for a client setting. Valid values are: Decrease and Increase.

Parameter properties

Parameter sets

-PromptUserForPermission

Indicates whether a client computer displays a message asking for user permission before it allows a remote control session.

Parameter properties

Parameter sets

-RebootLogoffNotificationCountdownMins

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-RebootLogoffNotificationFinalWindowMins

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-RemoteAssistanceAccessLevel

Specifies a level of access to assign to remote assistance sessions initiated in Configuration Manager. A user at the client computer always grants permission for a remote assistance session to occur. Valid values are:

• FullControl
• None
• RemoteViewing

Parameter properties

Parameter sets

-RemoteControl

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-RemoveThirdParty

Indicates whether to remove third party.

Parameter properties

Parameter sets

-ReplaceToastNotificationWithDialog

Specify whether to replace toast notifications with a more intrusive dialog window when a deployment requires a restart. It's an optional parameter and false by default.

Parameter properties

Parameter sets

-ReportingCycleMins

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-RequireAuthentication

Indicates whether to use network-level authentication to establish Remote Desktop connections to a client computer.

Parameter properties

Parameter sets

-ScanSchedule

Specifies a scan schedule as a schedule object. To obtain a schedule object, use the New-CMSchedule cmdlet.

Parameter properties

Parameter sets

-Schedule

Specifies a CMSchedule object. To create a CMSchedule object, use the New-CMSchedule cmdlet.

Parameter properties

Parameter sets

-SelectApplicationCatalogWebsitePoint

Don't use this parameter. The application catalog is no longer supported.

Parameter properties

Parameter sets

-ShowNotificationIconOnTaskbar

Indicates whether to display an icon on the taskbar of a client computer to indicate an active remote control session.

Parameter properties

Parameter sets

-ShowSessionConnectionBar

Indicates whether to display a high-visibility session connection bar on a client computer to specify an active remote control session.

Parameter properties

Parameter sets

-SoftwareDeployment

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-SoftwareInventory

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-SoftwareInventoryFileDisplayName

Specifies the display name to use in place of an inventoried name specified by the SoftwareInventoryFileInventoriedName parameter. This parameter allows you to standardize inventory information for software names that differ in different file headers.

Parameter properties

Parameter sets

-SoftwareInventoryFileInventoriedName

Specifies an inventoried manufacturer or product name. During software inventory, Configuration Manager gets inventoried names from header information on client devices.

Parameter properties

Parameter sets

-SoftwareInventoryFileName

Specifies a name for the file you want to collect during inventory. You can use the wildcard (*) to represent any string of text and the question mark (?) to represent any single character.

Parameter properties

Parameter sets

-SoftwareMetering

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-SoftwareUpdate

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-StateMessage

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-SuppressReboot

Indicates whether to bypass a required computer restart after installing the System Center 2016 Endpoint Protection client.

Parameter properties

Parameter sets

-SuspendBitLocker

Specifies whether to bypass a required BitLocker Drive Encryption PIN entry when a computer restarts after a software installation. This setting applies only when Configuration Manager initiates a restart. Valid values are:

• Always. Configuration Manager temporarily suspends the BitLocker requirement to enter a PIN.
• Never. Configuration Manager does not suspend the BitLocker requirement to enter a PIN on the next computer startup after it has installed software that requires a restart.

If you select Never, the software installation cannot finish until the user enters the PIN to complete the standard startup process.

Parameter properties

Parameter sets

-TimeUnit

Specifies the unit for the value specified in the BatchingTimeout parameter. Valid values are: Hours and Days.

Parameter properties

Parameter sets

-UsageThresholdDays

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-UseNewSoftwareCenter

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-UserDeviceAffinity

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-UseUtcForEvaluationTime

Indicates whether to use Coordinated Universal Time (UTC), also known as Greenwich Mean Time, to configure a recurring interval. If you specify $False, Configuration Manager uses local time.

Parameter properties

Parameter sets

-WakeOnLanPort

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-WakeupProxyDirectAccessPrefix

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-WakeupProxyPort

The Set-CMClientSetting cmdlet changes client settings for Configuration Manager devices and users. Configuration Manager provides default values for all client settings, but you can use this cmdlet to modify settings objects. Settings objects determine settings for individual clients. For more information, see About client settings.

To modify a client setting, specify it by name.

Parameter properties

Parameter sets

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Parameter properties

Parameter sets

CommonParameters

Inputs

None

Outputs

System.Object

Notes

Related Links

• About client settings
• Get-CMClientSetting
• New-CMClientSetting
• Remove-CMClientSetting
• New-CMSchedule
• Set-CMClientSettingBackgroundIntelligentTransfer
• Set-CMClientSettingClientCache
• Set-CMClientSettingClientPolicy
• Set-CMClientSettingCloudService
• Set-CMClientSettingComplianceSetting
• Set-CMClientSettingComputerAgent
• Set-CMClientSettingComputerRestart
• Set-CMClientSettingDeliveryOptimization
• Set-CMClientSettingEndpointProtection
• Set-CMClientSettingEnrollment
• Set-CMClientSettingGeneral
• Set-CMClientSettingHardwareInventory
• Set-CMClientSettingMeteredInternetConnection
• Set-CMClientSettingPowerManagement
• Set-CMClientSettingRemoteTool
• Set-CMClientSettingSoftwareCenter
• Set-CMClientSettingSoftwareDeployment
• Set-CMClientSettingSoftwareInventory
• Set-CMClientSettingSoftwareMetering
• Set-CMClientSettingSoftwareUpdate
• Set-CMClientSettingStateMessaging
• Set-CMClientSettingUserAndDeviceAffinity