Set-​CM​Client​Setting

Changes client settings for Configuration Manager devices and users.

Syntax

Set-CMClientSetting
   [-AccessLevel <AccessLevelType>]
   [-AllowClientChange <Boolean>]
   [-AllowPermittedViewer <Boolean>]
   [-AllowRemoteControlOfUnattendedComputer <Boolean>]
   [-AudibleSignal <AudibleSignalType>]
   [-Confirm]
   [-DisableWildcardHandling]
   [-FirewallExceptionProfile <FirewallExceptionProfileType[]>]
   [-ForceWildcardHandling]
   [-GrantRemoteControlPermissionToLocalAdministrator <Boolean>]
   [-ManageRemoteDesktopSetting <Boolean>]
   [-ManageSolicitedRemoteAssistance <Boolean>]
   [-ManageUnsolicitedRemoteAssistance <Boolean>]
   -Name <String>
   [-PassThru]
   [-PermittedViewer <String[]>]
   [-PromptUserForPermission <Boolean>]
   [-RemoteAssistanceAccessLevel <RemoteAssistanceAccessLevelType>]
   [-RemoteControl]
   [-RequireAuthentication <Boolean>]
   [-ShowNotificationIconOnTaskbar <Boolean>]
   [-ShowSessionConnectionBar <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-AddPortalToTrustedSiteList <Boolean>]
   [-AllowPortalToHaveElevatedTrust <Boolean>]
   [-ApplicationCatalogWebsitePointServerName <String>]
   [-BrandingTitle <String>]
   [-ComputerAgent]
   [-Confirm]
   [-DisableWildcardHandling]
   [-DisplayNewProgramNotification <Boolean>]
   [-EnableThirdPartyOrchestration <EnableThirdPartyOrchestrationType>]
   [-FinalReminderMins <Int32>]
   [-ForceWildcardHandling]
   [-InitialReminderHours <Int32>]
   [-InstallRestriction <InstallRestrictionType>]
   [-InterimReminderHours <Int32>]
   -Name <String>
   [-PassThru]
   [-PortalUrl <String>]
   [-PowerShellExecutionPolicy <PowerShellExecutionPolicyType>]
   [-SelectApplicationCatalogWebsitePoint <ApplicationCatalogWebsitePointType>]
   [-SuspendBitLocker <SuspendBitLockerType>]
   [-UseNewSoftwareCenter <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-AllowCloudDistributionPoint <Boolean>]
   [-CloudService]
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-AllowUserAffinity <Boolean>]
   [-AutoApproveAffinity <Boolean>]
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-LogOnThresholdMins <Int32>]
   -Name <String>
   [-PassThru]
   [-UsageThresholdDays <Int32>]
   [-UserDeviceAffinity]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-AllowUserToOptOutFromPowerPlan <Boolean>]
   [-Confirm]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-EnableWakeupProxy <Boolean>]
   [-FirewallExceptionForWakeupProxy <WakeUpProxyFirewallExceptionTypes>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-PowerManagement]
   [-WakeOnLanPort <Int32>]
   [-WakeupProxyDirectAccessPrefix <String>]
   [-WakeupProxyPort <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-BatchingTimeout <Int32>]
   [-Confirm]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-ScanSchedule <IResultObject>]
   [-SoftwareUpdate]
   [-TimeUnit <BatchingTimeoutType>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Bits]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableBitsMaxBandwidth <Boolean>]
   [-EnableDownloadOffSchedule <Boolean>]
   [-ForceWildcardHandling]
   [-MaxBandwidthBeginHr <Int32>]
   [-MaxBandwidthEndHr <Int32>]
   [-MaxTransferRateOffSchedule <Int32>]
   [-MaxTransferRateOnSchedule <Int32>]
   -Name <String>
   [-PassThru]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-ClientPolicy]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableUserPolicy <Boolean>]
   [-EnableUserPolicyOnInternet <Boolean>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-PolicyPollingMins <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Compliance]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableComplianceEvaluation <Boolean>]
   [-EnableUserDataAndProfile <Boolean>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-ComputerRestart]
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-RebootLogoffNotificationCountdownMins <Int32>]
   [-RebootLogoffNotificationFinalWindowMins <Int32>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Priority <PriorityChangeType>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableFirstSignatureUpdate <Boolean>]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-EndpointProtection]
   [-ForceRebootHr <Int32>]
   [-ForceWildcardHandling]
   [-InstallEndpointProtectionClient <Boolean>]
   -Name <String>
   [-PassThru]
   [-RemoveThirdParty <Boolean>]
   [-SuppressReboot <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-ForceWildcardHandling]
   [-HardwareInventory]
   [-InventoryReportId <String>]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-Enrollment]
   [-EnrollmentProfileName <String>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-ForceScan <Boolean>]
   [-ForceWildcardHandling]
   -Name <String>
   [-NetworkAccessProtection]
   [-PassThru]
   [-Schedule <IResultObject>]
   [-UseUtcForEvaluationTime <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-SoftwareMetering]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-Enable <Boolean>]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-SoftwareInventory]
   [-SoftwareInventoryFileDisplayName <String>]
   [-SoftwareInventoryFileInventoriedName <String>]
   [-SoftwareInventoryFileName <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-MeteredNetwork]
   [-MeteredNetworkUsage <MeteredNetworkUsageType>]
   -Name <String>
   [-PassThru]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-ReportingCycleMins <Int32>]
   [-StateMessage]
   [-WhatIf]
   [<CommonParameters>]
Set-CMClientSetting
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-SoftwareDeployment]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-CMClientSetting cmdlet changes client settings for Microsoft System Center Configuration Manager devices and users. System Center 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 about client settings, see About Client Settings in Configuration Manager on TechNet.

Client settings for devices include the following categories:

- Client Policy

  • Computer Agent
  • Computer Restart
  • System Center 2016 Endpoint Protection
  • Hardware Inventory
  • Metered Internet Connections
  • Network Access Protection (NAP)
  • Power Options
  • Remote Tools
  • Software Deployment
  • Software Inventory
  • Software Updates
  • User and Device Affinity

    Client settings for users include the following categories:

    - Mobile Devices
  • User and Device Affinity

    To modify a client setting, specify it by name.

Examples

Example 1: Rename a client setting

PS C:\> Set-CMClientSetting -Name "Client Settings Main" -Description "Client settings for TSQA office site." -NewName "Client Settings TSQA"

This command renames the client setting object. The new name is Client Settings TSQA. The command also adds a description for the client setting object.

Example 2: Configure power management

PS C:\> Set-CMClientSetting -Name "TSQA02" -AllowUserToOptOutFromPowerPlan $True -EnablePowerManagement $False

This command allows users to opt out of power plans and disables power management for the clients with the setting named TSQA02.

Example 3: Set state messaging reporting cycle value

PS C:\> Set-CMClientSetting -Name "TSQA02" -StateMessagingReportingCycleMinutes 10

This command sets a state messaging reporting cycle value of 10 minutes.

Example 4: Configure user affinity

PS C:\> Set-CMClientSetting -Name "TSQA03" -AutoApproveAffinity $False -UserAffinityLogOnThresholdMinutes 2800 -UserAffinityUsageThresholdDays 20

This command configures user affinity settings for a client setting named TSQA03. The command disables auto approval of affinity. The command sets the UserAffinityLogOnThresholdMinutes parameter to 2800 minutes and the UserAffinityUsageThresholdDays parameter to 20 days, so if a user uses a device for 2800 minutes over a period of 20 days, Configuration Manager creates a user device affinity.

Example 5: Allow user affinity

PS C:\> Set-CMClientSetting -Name "TSQA04" -AllowUserAffinity $True

This command changes the client setting named TSQA04 to have a client automatically configure user device affinity from usage data.

Example 6: Set bandwidth for client

PS C:\> Set-CMClientSetting -Name "TSQA05" -EnableBITSMaxBandwidth $True EnableDownloadOffSchedule $True -MaxBandwidthValidFrom 8 -MaxBandwidthValidTo 15 -MaxTransferRateOnSchedule 1500

This command changes settings for the client settings object named TSQA05. The command enables maximum bandwidth for BITS transfers and enables off schedule downloads. The command also specifies values for maximum bandwidth value from and to and maximum transfer rate on schedule.

Example 7: Configure user policies on the Internet

PS C:\> Set-CMClientSetting -Name "TSQA06" -EnableUserPolicyOnInternet $True -EnableUserPolicyPolling $False -EnableUserPolicyOnInternet $True -PolicyPollingInterval 50

This command changes settings for the client settings object named TSQA06. The command enables user policy on the Internet, enables user policy polling, and sets a policy polling interval.

Example 8: Disable compliance evaluation

PS C:\> Set-CMClientSetting -Name "TSQA07" -EnableComplianceEvaluation $False

This command disables compliance evaluation for the setting named TSQA07.

Example 9: Set computer agent settings

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

This command changes settings for the client settings object named TSQA09. The command specifies a portal and adds that portal to the trusted site list and allows it to have elevated trust. The command specifies a branding title, Contoso IT. The command enables third party orchestration. The command sets final reminder and initial reminder intervals. The command also specifies that only administrators can install software, selects Bypass as the Windows PowerShell execution policy, and suspends a BitLocker PIN requirement.

Example 10: Configure restart settings

PS C:\> Set-CMClientSetting -Name "TSQA11" -RebootLogoffNotificationCountdownDuration 12 -RebootLogoffNotificationFinalWindowMinutes 80

This command sets restart logoff notification countdown duration and logoff notification final window duration for a client setting object named TSQA11.

Example 11: Configure metered network usage

PS C:\> Set-CMClientSetting -Name "TSQA21" -MeteredNetworkUsage Limit

This command specifies the type of metered network usage for the client setting object named TSQA21 as Limit.

Required Parameters

-Bits
Type:SwitchParameter
Aliases:BitsSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClientPolicy
Type:SwitchParameter
Aliases:ClientPolicySettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CloudService
Type:SwitchParameter
Aliases:CloudServicesSettings, CloudServices
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Compliance
Type:SwitchParameter
Aliases:ComplianceSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerAgent
Type:SwitchParameter
Aliases:ComputerAgentSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerRestart
Type:SwitchParameter
Aliases:ComputerRestartSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EndpointProtection
Type:SwitchParameter
Aliases:EndpointProtectionSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Enrollment
Type:SwitchParameter
Aliases:EnrollmentSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-HardwareInventory
Type:SwitchParameter
Aliases:HardwareInventorySettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MeteredNetwork
Type:SwitchParameter
Aliases:MeteredNetworkSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies a name for a client setting.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NetworkAccessProtection
Type:SwitchParameter
Aliases:NetworkAccessProtectionSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PowerManagement
Type:SwitchParameter
Aliases:PowerManagementSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoteControl
Type:SwitchParameter
Aliases:RemoteToolsSettings, RemoteTools
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareDeployment
Type:SwitchParameter
Aliases:SoftwareDeploymentSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareInventory
Type:SwitchParameter
Aliases:SoftwareInventorySettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareMetering
Type:SwitchParameter
Aliases:SoftwareMeteringSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareUpdate
Type:SwitchParameter
Aliases:SoftwareUpdatesSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StateMessage
Type:SwitchParameter
Aliases:StateMessageSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDeviceAffinity
Type:SwitchParameter
Aliases:UserDeviceAffinitySettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AccessLevel

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

  • NoAccess
  • None
  • ViewOnly
Type:AccessLevelType
Parameter Sets:NoAccess, ViewOnly, FullControl
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AddPortalToTrustedSiteList

Indicates whether to add the default Application Catalog website to the Internet Explorer trusted sites zone.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowClientChange

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowCloudDistributionPoint

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPermittedViewer
Type:Boolean
Aliases:AllowPermittedViewersToRemoteDesktop
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowPortalToHaveElevatedTrust

Indicates whether to allow a portal to have elevated trust.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowRemoteControlOfUnattendedComputer

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowUserAffinity

Indicates whether users can define their primary devices.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowUserToOptOutFromPowerPlan

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ApplicationCatalogWebsitePointServerName
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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
Type:AudibleSignalType
Parameter Sets:PlayNoSound, PlaySoundAtBeginAndEnd, PlaySoundRepeatedly
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AutoApproveAffinity

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BrandingTitle

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DeploymentEvaluationSchedule

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for client settings.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableFirstSignatureUpdate

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Enable

Indicates whether to enable client settings.

Type:Boolean
Aliases:EnableEndpointProtection, EnablePowerManagement, EnableHardwareInventory, EnableDeviceEnrollment, EnableNetworkAccessProtection, EnableSoftwareMetering, EnableSoftwareUpdatesOnClient, EnableSoftwareInventory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableBitsMaxBandwidth

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableComplianceEvaluation

Indicates whether to enable compliance evaluation for this client.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableDownloadOffSchedule

Specifies whether allow BITS downloads outside of a throttling window.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:EnableThirdPartyOrchestrationType
Parameter Sets:No, Yes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableUserDataAndProfile

Indicates whether to enable user data and profile settings.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableUserPolicy
Type:Boolean
Aliases:EnableUserPolicyPolling
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableWakeupProxy
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnforceMandatory

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnrollmentProfileName
Type:String
Aliases:DeviceEnrollmentProfileName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FinalReminderMins
Type:Int32
Aliases:FinalReminderMinutesInterval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FirewallExceptionForWakeupProxy
Type:WakeUpProxyFirewallExceptionTypes
Aliases:WindowsFirewallExceptionsForWakeUpProxy
Parameter Sets:None, Public, Private, Domain
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FirewallExceptionProfile

Specifies a firewall exception profile. Valid values are:- Disabled

  • Domain
  • Private
  • Public
Type:FirewallExceptionProfileType[]
Parameter Sets:Disabled, Public, Private, Domain
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceRebootHr
Type:Int32
Aliases:ForceRebootPeriod, ForceRebootHours
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceScan

Indicates whether to enable force scan.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-GrantRemoteControlPermissionToLocalAdministrator

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InitialReminderHours
Type:Int32
Aliases:InitialReminderHoursInterval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InstallEndpointProtectionClient

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InstallRestriction

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

  • NoUsers
  • OnlyAdministrators
  • OnlyAdministratorsAndPrimaryUsers
Type:InstallRestrictionType
Parameter Sets:AllUsers, OnlyAdministrators, OnlyAdministratorsAndPrimaryUsers, NoUsers
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InterimReminderHours
Type:Int32
Aliases:InterimReminderHoursInterval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InventoryReportId

Specifies an inventory report ID.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LogOnThresholdMins
Type:Int32
Aliases:UserAffinityLogOnThresholdMinutes, UserAffinityLogOnThresholdMins
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ManageRemoteDesktopSetting

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ManageSolicitedRemoteAssistance

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ManageUnsolicitedRemoteAssistance

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxBandwidthBeginHr
Type:Int32
Aliases:MaxBandwidthValidFrom
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxBandwidthEndHr
Type:Int32
Aliases:MaxBandwidthValidTo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxTransferRateOffSchedule

Specifies an integer value for maximum transfer rate off schedule.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxTransferRateOnSchedule

Specifies an integer value for maximum transfer rate on schedule.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MeteredNetworkUsage

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

  • Block
  • Limit
  • None
Type:MeteredNetworkUsageType
Parameter Sets:None, Allow, Limit, Block
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

Specifies a new name for a client setting.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns the current working object. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PermittedViewer

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

Type:String[]
Aliases:PermittedViewers
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PolicyPollingMins
Type:Int32
Aliases:PolicyPollingInterval, PollingIntervalMins
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PortalUrl

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.
Type:PowerShellExecutionPolicyType
Parameter Sets:AllSigned, Bypass, Restricted
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Priority

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

Type:PriorityChangeType
Parameter Sets:Increase, Decrease
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PromptUserForPermission

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RebootLogoffNotificationCountdownMins
Type:Int32
Aliases:RebootLogoffNotificationCountdownDurationMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RebootLogoffNotificationFinalWindowMins
Type:Int32
Aliases:RebootLogoffNotificationFinalWindowMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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
Type:RemoteAssistanceAccessLevelType
Parameter Sets:None, RemoteViewing, FullControl
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveThirdParty

Indicates whether to remove third party.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ReportingCycleMins
Type:Int32
Aliases:StateMessagingReportingCycleMinutes, StateMessagingReportingCycleMins
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RequireAuthentication

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScanSchedule

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Schedule

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

Type:IResultObject
Aliases:InventorySchedule, NapEvaluationSchedule, EvaluationSchedule, DataCollectionSchedule, SoftwareInventorySchedule
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SelectApplicationCatalogWebsitePoint
Type:ApplicationCatalogWebsitePointType
Parameter Sets:Fqdn, AutoDetect, NetBios
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ShowNotificationIconOnTaskbar

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ShowSessionConnectionBar

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareInventoryFileInventoriedName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SuppressReboot

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.
Type:SuspendBitLockerType
Parameter Sets:Never, Always
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TimeUnit

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

Type:BatchingTimeoutType
Parameter Sets:Days, Hours
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UsageThresholdDays
Type:Int32
Aliases:UserAffinityUsageThresholdDays
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseNewSoftwareCenter
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WakeOnLanPort
Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WakeupProxyDirectAccessPrefix
Type:String
Aliases:IPv6PrefixesForDirectAccessOrInterveningNetworkDevices
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WakeupProxyPort
Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False