Edit

Share via


Set-CMMicrosoftEdgeBrowserProfiles

Configure a policy for a Microsoft Edge Legacy browser profile.

Syntax

ById (Default)

Set-CMMicrosoftEdgeBrowserProfiles
    -Id <Int32>
    [-NewName <String>]
    [-PassThru]
    [-SupportedPlatform <IResultObject[]>]
    [-AllowAddressBarDropDown <EdgeBrowserSettingType>]
    [-AllowAutoFill <EdgeBrowserSettingType>]
    [-AllowCookies <EdgeBrowserSettingType>]
    [-AllowDeveloperTools <EdgeBrowserSettingType>]
    [-AllowDoNotTrack <EdgeBrowserSettingType>]
    [-AllowExtensions <EdgeBrowserSettingType>]
    [-AllowPasswordManager <EdgeBrowserSettingType>]
    [-AllowPopups <EdgeBrowserSettingType>]
    [-AllowSearchSuggestions <EdgeBrowserSettingType>]
    [-AllowSmartScreen <EdgeBrowserSettingType>]
    [-ClearBrowsingDataOnExit <EdgeBrowserSettingType>]
    [-Description <String>]
    [-PreventOverrideFiles <EdgeBrowserSettingType>]
    [-PreventPromptOverride <EdgeBrowserSettingType>]
    [-SendIntranetTrafficToIE <EdgeBrowserSettingType>]
    [-SetEdgeBrowserAsDefault <EdgeBrowserAsDefaultSettingType>]
    [-SyncFavoritesIEAndEdge <EdgeBrowserSettingType>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByValue

Set-CMMicrosoftEdgeBrowserProfiles
    -InputObject <IResultObject>
    [-NewName <String>]
    [-PassThru]
    [-SupportedPlatform <IResultObject[]>]
    [-AllowAddressBarDropDown <EdgeBrowserSettingType>]
    [-AllowAutoFill <EdgeBrowserSettingType>]
    [-AllowCookies <EdgeBrowserSettingType>]
    [-AllowDeveloperTools <EdgeBrowserSettingType>]
    [-AllowDoNotTrack <EdgeBrowserSettingType>]
    [-AllowExtensions <EdgeBrowserSettingType>]
    [-AllowPasswordManager <EdgeBrowserSettingType>]
    [-AllowPopups <EdgeBrowserSettingType>]
    [-AllowSearchSuggestions <EdgeBrowserSettingType>]
    [-AllowSmartScreen <EdgeBrowserSettingType>]
    [-ClearBrowsingDataOnExit <EdgeBrowserSettingType>]
    [-Description <String>]
    [-PreventOverrideFiles <EdgeBrowserSettingType>]
    [-PreventPromptOverride <EdgeBrowserSettingType>]
    [-SendIntranetTrafficToIE <EdgeBrowserSettingType>]
    [-SetEdgeBrowserAsDefault <EdgeBrowserAsDefaultSettingType>]
    [-SyncFavoritesIEAndEdge <EdgeBrowserSettingType>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Set-CMMicrosoftEdgeBrowserProfiles
    -Name <String>
    [-NewName <String>]
    [-PassThru]
    [-SupportedPlatform <IResultObject[]>]
    [-AllowAddressBarDropDown <EdgeBrowserSettingType>]
    [-AllowAutoFill <EdgeBrowserSettingType>]
    [-AllowCookies <EdgeBrowserSettingType>]
    [-AllowDeveloperTools <EdgeBrowserSettingType>]
    [-AllowDoNotTrack <EdgeBrowserSettingType>]
    [-AllowExtensions <EdgeBrowserSettingType>]
    [-AllowPasswordManager <EdgeBrowserSettingType>]
    [-AllowPopups <EdgeBrowserSettingType>]
    [-AllowSearchSuggestions <EdgeBrowserSettingType>]
    [-AllowSmartScreen <EdgeBrowserSettingType>]
    [-ClearBrowsingDataOnExit <EdgeBrowserSettingType>]
    [-Description <String>]
    [-PreventOverrideFiles <EdgeBrowserSettingType>]
    [-PreventPromptOverride <EdgeBrowserSettingType>]
    [-SendIntranetTrafficToIE <EdgeBrowserSettingType>]
    [-SetEdgeBrowserAsDefault <EdgeBrowserAsDefaultSettingType>]
    [-SyncFavoritesIEAndEdge <EdgeBrowserSettingType>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Configure a policy for a Microsoft Edge Legacy browser profile. This policy only applies to clients on Windows 10, version 1703 or later, and Microsoft Edge Legacy version 45 and earlier. For more information, see Configure Microsoft Edge Legacy settings in Configuration Manager. This article also includes more details on the specific policy settings.

For more information on managing Microsoft Edge version 77 or later with Configuration Manager, see Deploy Microsoft Edge, version 77 and later. For more information on configuring policies for Microsoft Edge version 77 or later, see Microsoft Edge - Policies.

Examples

Example 1

Set-CMMicrosoftEdgeBrowserProfiles -Name "Edge1" -AllowAddressBarDropDown NotConfigured -AllowAutoFill NotConfigured -AllowCookies NotConfigured -AllowDeveloperTools NotConfigured -AllowDoNotTrack NotConfigured -AllowExtensions NotConfigured -AllowPasswordManager NotConfigured -AllowPopups NotConfigured -AllowSearchSuggestions NotConfigured -AllowSmartScreen NotConfigured -ClearBrowsingDataOnExit NotConfigured -Description "Edge1" -PreventOverrideFiles NotConfigured -PreventPromptOverride NotConfigured -SendIntranetTrafficToIE NotConfigured -SetEdgeBrowserAsDefault Configured -SyncFavoritesIEAndEdge NotConfigured

Parameters

-AllowAddressBarDropDown

Configure the setting to Allow address bar drop-down.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowAutoFill

Configure the setting to Allow autofill.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowCookies

Configure the setting to Allow cookies.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowDeveloperTools

Configure the setting to Allow Developer Tools.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowDoNotTrack

Configure the setting to Allow Do Not Track headers.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowExtensions

Configure the setting to Allow extensions.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowPasswordManager

Configure the setting to Allow password manager.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowPopups

Configure the setting to Allow pop-up blocker.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowSearchSuggestions

Configure the setting to Allow search suggestions in address bar.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False
Aliases:AllowSearchSuggestionsinAddressBar

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowSmartScreen

Configure the Microsoft Defender SmartScreen setting to Allow SmartScreen.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClearBrowsingDataOnExit

Configure the setting to Allow clear browsing data on exit.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

Specify an optional description for the browser profile policy.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:LocalizedDescription

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

Specify the CI ID of the browser profile to configure. The format is a five- to seven-digit number, for example 403823.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:CIId, CI_ID

Parameter sets

ById
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Specify a browser profile policy object to configure. To get this object, use the Get-CMMicrosoftEdgeBrowserProfiles cmdlet.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:MicrosoftEdgeBrowserPolicy

Parameter sets

ByValue
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specify the name of the browser profile to configure.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:LocalizedDisplayName

Parameter sets

ByName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NewName

To rename this browser profile policy, specify a new name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-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

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PreventOverrideFiles

Configure the Microsoft Defender SmartScreen setting: Users can override SmartScreen prompt for files.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False
Aliases:PreventSmartScreenPromptOverrideForFiles

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PreventPromptOverride

Configure the Microsoft Defender SmartScreen setting: Users can override SmartScreen prompt for sites.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False
Aliases:PreventSmartScreenPromptOverride

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SendIntranetTrafficToIE

Configure the setting to Allow send intranet traffic to Internet Explorer.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False
Aliases:SendIntranetTrafficToInternetExplorer

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SetEdgeBrowserAsDefault

Configure the setting to Set Microsoft Edge browser as default. If you configure this setting, Configuration Manager configures the Windows 10 default app setting for web browser to Microsoft Edge Legacy.

Parameter properties

Type:EdgeBrowserAsDefaultSettingType
Default value:None
Accepted values:Configured, NotConfigured
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SupportedPlatform

Specify a supported platform object to which this policy is applicable. To get this object, use the Get-CMSupportedPlatform cmdlet.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:SupportedPlatforms

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SyncFavoritesIEAndEdge

Configure the setting to Allow sync favorites between Microsoft browsers.

Parameter properties

Type:EdgeBrowserSettingType
Default value:None
Accepted values:Allow, NotAllow, NotConfigured
Supports wildcards:False
DontShow:False
Aliases:SyncFavoritesBetweenIEAndMicrosoftEdge

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject