Share via


Set-MDISensorProxyConfiguration

Sets the proxy configuration for the Defender for Identity sensor.

Syntax

Default (Default)

Set-MDISensorProxyConfiguration
    [[-ProxyUrl] <String>]
    [[-ProxyCredential] <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

This cmdlet sets the proxy configuration for the Defender for Identity sensor. If the ProxyUrl parameter is null or empty, the function clears the proxy configuration. If you specify the ProxyCredential parameter, the function encrypts the password and stores it in the sensor configuration file.

Examples

EXAMPLE 1

Set-MDISensorProxyConfiguration -ProxyUrl 'http://proxy.contoso.com:8080' -ProxyCredential $Credential

This example sets the proxy configuration for the Defender for Identity sensor to use the specified proxy server and credentials.

EXAMPLE 2

Set-MDISensorProxyConfiguration -ProxyUrl 'http://proxy.contoso.com:8080'

This example sets the proxy configuration for the Defender for Identity sensor to use the specified proxy server without any credentials.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:False
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

-ProxyCredential

The credentials to use to authenticate with the proxy server. You can use Get-Credential to create a credential object.

Parameter properties

Type:System.Management.Automation.PSCredential
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

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

-ProxyUrl

The URL of the proxy server.

Parameter properties

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

Parameter sets

(All)
Position:1
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 isn't run.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:False
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.