Edit

Share via


Set-CMExchangeServer

Changes settings for an Exchange server.

Syntax

Default (Default)

Set-CMExchangeServer
    [-AccessLevel <AccessLevelType>]
    [-AccessRule <ExchangeConnectorAccessRule[]>]
    [-ActiveDirectoryContainer <String[]>]
    [-AllowExternalDeviceManagement <Boolean>]
    [-ApplicationSetting <ExchangeConnectorApplicationSetting>]
    [-DeltaSyncMins <Int32>]
    [-EmailAddress <String[]>]
    [-EmailManagementSetting <ExchangeConnectorEmailManagementSetting>]
    [-EnableAccessRule <Boolean>]
    [-ExchangeClientAccessServer <Dictionary`2[]>]
    [-FindAll]
    [-FullSyncSchedule <IResultObject>]
    [-GeneralSetting <ExchangeConnectorGeneralSetting>]
    [-IsHosted <Boolean>]
    [-MaximumInactiveDays <Int32>]
    [-NewServerAddress <String>]
    [-NotificationUserName <String>]
    [-PasswordSetting <ExchangeConnectorPasswordSetting>]
    [-SecuritySetting <ExchangeConnectorSecuritySetting>]
    -ServerAddress <String>
    [-SiteCode <String>]
    [-UserName <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-CMExchangeServer cmdlet changes settings for a Microsoft Exchange Server.

Configuration Manager works with Exchange Server to manage mobile devices that cannot run Configuration Manager clients.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Change settings for an nextref_exchange

PS XYZ:\> $Gs= New-CMExchangeConnectorGeneralSetting -AllowInternetShare $True -AllowDesktopSync $True -AllowNonProvision $True -RefreshInterval 4
PS XYZ:\> $Ps= New-CMExchangeConnectorPasswordSetting -PasswordEnabled $True -MinimumPasswordLength 8 -PasswordExpiration 51 -PasswordHistory 21 -WipeAfterFailedAttempt 6 -MaximumIdleTimeMinutes 41 -PasswordComplexity
PS XYZ:\> $Em = New-CMExchangeConnectorEmailManagementSetting -ConsumerEmail $True -MaximumEmailAge OneDay -MaximumCalenderAge ThreeMonths -PushWhenRoaming $True -AllowHtmlEmail $True -EmailAttachmentPolicy $True -MaximumSizeTextEmail 401 -MaximumSizeHtmlEmail 402 -MaximumSizeAttachment 24
PS XYZ:\> $Ss = New-CMExchangeConnectorSecuritySetting -RemoteDesktop $True -StorageCard $True -Camera $True -Bluetooth $False -WiFiConnection HandsfreeOnly -Infra $False -Browser $False -StorageCardEncrypt $False -FileEncrypt $False -TextMessage $False
PS XYZ:\> $As= New-CMExchangeConnectorApplicationSetting -UnsignedInstall $True -UnsignedApplication $False -BlockedApplication "App01","App02"
PS XYZ:\> Set-CMExchangeServer -SiteCode "CM2" -ServerAddress "https://www.contoso.com/powershell" -NewServerAddress "www.fabrikam.com" -UserName "ElisaDaugherty@contoso.com" -DeltaSyncInterval 124 -MaximumInactiveDay 26 -FindAll -AllowExternalDeviceManagement $False -EnableAccessRule $True -AccessLevel Allow -EmailAddress "EvanNarvaez@fabrikam.com","DavidChew@contosco.com" -GeneralSetting $Gs -PasswordSetting $Ps -EmailManagementSetting $Em -SecuritySetting $Ss -ApplicationSetting $As

The first command uses the New-CMExchangeConnectorGeneralSetting cmdlet to add new settings to an Exchange Server connector in Configuration Manager, and stores the settings in the $Gs variable.

The second command uses the New-CMExchangeConnectorPasswordSetting cmdlet adds new password settings to an Exchange Server connector in Configuration Manager, and stores the password settings in the $Ps variable.

The third command uses the New-CMExchangeConnectorEmailManagementSetting cmdlet creates a set of e-mail management settings for a mobile device that uses an Exchange Server connector, and stores the password settings in the $Em variable.

The fourth command uses the New-CMExchangeConnectorSecuritySetting cmdlet configures security options for an Exchange Server connector in Configuration Manager, and security settings in the $Ss variable.

The fifth command uses the New-CMExchangeConnectorApplicationSetting cmdlet creates application-related settings for a mobile device that uses an Exchange Server connector, and stores the application settings in the $As variable.

The final command changes settings for an Exchange Server for the Configuration Manager site that has the site code CM2. The command specifies the general settings for the Exchange Server connector stored in $Gs. The command specifies password settings for the Exchange Server connector stored in $Ps. The command specifies a set of e-mail management settings for the Exchange Server connector stored in $Em. The command specifies the security options for the Exchange Server connector stored in $Ss. The command specifies application-related settings for a mobile device stored in $As.

Parameters

-AccessLevel

Specifies the type of access for the mobile devices. Access level applies to a mobile device that is not managed by a rule. Valid values are:

  • Allow
  • Block
  • Quarantine

Parameter properties

Type:AccessLevelType
Default value:None
Accepted values:Allow, Block, Quarantine
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

-AccessRule

The Set-CMExchangeServer cmdlet changes settings for a Microsoft Exchange Server.

Configuration Manager works with Exchange Server to manage mobile devices that cannot run Configuration Manager clients.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:

ExchangeConnectorAccessRule[]

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

Parameter sets

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

-ActiveDirectoryContainer

Specifies an array of names of Active Directory containers. When this parameter appears, the Exchange Server connector searches for the device only in the Active Directory containers.

Parameter properties

Type:

String[]

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

Parameter sets

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

-AllowExternalDeviceManagement

Indicates whether an external device management program can manage the device.

Parameter properties

Type:Boolean
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

-ApplicationSetting

Specifies application settings, such as allow or deny the installation of applications. For each dictionary entry in the array, specify the setting name as the key the configuration as the value. Valid values are: AllowUnsignedApplications, AllowUnsignedInstallationPackages, or Block a specific application.

Parameter properties

Type:ExchangeConnectorApplicationSetting
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

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type: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

-DeltaSyncMins

The Set-CMExchangeServer cmdlet changes settings for a Microsoft Exchange Server.

Configuration Manager works with Exchange Server to manage mobile devices that cannot run Configuration Manager clients.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:DeltaSyncInterval

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

-EmailAddress

Specifies an array of email addresses.

Parameter properties

Type:

String[]

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

Parameter sets

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

-EmailManagementSetting

Specifies email management settings, such as synchronization schedule, message format, and size of attachments. For each dictionary entry in the array, specify the setting name as the key and the configuration as the value.

Parameter properties

Type:ExchangeConnectorEmailManagementSetting
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

-EnableAccessRule

Indicates whether to enable an access rule.

Parameter properties

Type:Boolean
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

-ExchangeClientAccessServer

Specifies Exchange Client Access servers, as key-value pairs.

Parameter properties

Type:

Dictionary`2[]

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

-FindAll

Indicates that the discovery process find all mobile devices in an Exchange organization.

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

-FullSyncSchedule

Specifies a result object that schedules the full discovery time for an Exchange Server connector.

Parameter properties

Type:IResultObject
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

-GeneralSetting

Specifies general settings for mobile devices that use the Exchange Server Connector. Settings you can specify for this parameter include:

  • RequireManualSyncWhenRoaming
  • RequireStorageCardEncryption
  • UnapprovedInROMApplicationList
  • DevicePolicyRefreshInterval
  • MaxInactivityTimeDeviceLock

Parameter properties

Type:ExchangeConnectorGeneralSetting
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

-IsHosted

Indicates that the Exchange Server connector configuration is for a hosted or on-premise Exchange Server.

Parameter properties

Type:Boolean
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

-MaximumInactiveDays

The Set-CMExchangeServer cmdlet changes settings for a Microsoft Exchange Server.

Configuration Manager works with Exchange Server to manage mobile devices that cannot run Configuration Manager clients.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:MaximumInactiveDay

Parameter sets

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

-NewServerAddress

Specifies a new server address for an Exchange server.

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

-NotificationUserName

{{ Fill NotificationUserName Description }}

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

-PasswordSetting

Specifies general password settings. Settings you can specify for this parameter include:

  • AlphanumericDevicePasswordRequired
  • DevicePasswordEnabled
  • DevicePasswordExpiration
  • DevicePasswordHistory
  • MaxDevicePasswordFailedAttempts
  • PasswordRecoveryEnabled
  • MinDevicePasswordComplexCharacters
  • MinDevicePasswordLength
  • AlphanumericDevicePasswordRequired
  • AllowSimpleDevicePassword

Parameter properties

Type:ExchangeConnectorPasswordSetting
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

-SecuritySetting

Specifies a dictionary of security settings. Settings you can specify for this parameter include:

  • AllowBluetooth
  • AllowBrowser
  • AllowCamera
  • AllowDesktopSync
  • AllowInternetSharing
  • AllowIrDA
  • AllowNonProvisionableDevices
  • AllowRemoteDesktop
  • AllowStorageCard
  • AllowTextMessaging
  • AllowWiFi

Parameter properties

Type:ExchangeConnectorSecuritySetting
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

-ServerAddress

Specifies the address of the Exchange Server for which the cmdlet configures the Exchange Server connector.

Parameter properties

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

Parameter sets

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

-SiteCode

Specifies the Exchange Server by using a site code.

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

-UserName

Specifies the user name that the connector uses to connect to the Exchange Server.

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

-WhatIf

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

Parameter properties

Type: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.

Inputs

None