Set-CMExchangeServer

Changes settings for an Exchange server.

Syntax

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

Description

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

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

Examples

Example 1: Change settings for an nextref_exchange

PS C:\> $Gs= New-CMExchangeServerConnectorGeneralSetting -AllowInternetShare $True -AllowDesktopSync $True -AllowNonProvision $True -RefreshInterval 4
PS C:\> $Ps= New-CMExchangeServerConnectorPasswordSetting -PasswordEnabled $True -MinimumPasswordLength 8 -PasswordExpiration 51 -PasswordHistory 21 -WipeAfterFailedAttempt 6 -MaximumIdleTimeMinutes 41 -PasswordComplexity
PS C:\> $Em = New-CMExchangeServerConnectorEmailManagementSetting -ConsumerEmail $True -MaximumEmailAge OneDay -MaximumCalenderAge ThreeMonths -PushWhenRoaming $True -AllowHtmlEmail $True -EmailAttachmentPolicy $True -MaximumSizeTextEmail 401 -MaximumSizeHtmlEmail 402 -MaximumSizeAttachment 24
PS C:\> $Ss = New-CMExchangeServerConnectorSecuritySetting -RemoteDesktop $True -StorageCard $True -Camera $True -Bluetooth $False -WiFiConnection HandsfreeOnly -Infra $False -Browser $False -StorageCardEncrypt $False -FileEncrypt $False -TextMessage $False
PS C:\> $As= New-CMExchangeServerConnectorApplicationSetting -UnsignedInstall $True -UnsignedApplication $False -BlockedApplication "App01","App02"
PS C:\> Set-CMExchangeServer -SiteCode "CM2" -ServerAddress "http://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-CMExchangeServerConnectorGeneralSetting 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-CMExchangeServerConnectorPasswordSetting 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-CMExchangeServerConnectorEmailManagementSetting 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-CMExchangeServerConnectorSecuritySetting 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-CMExchangeServerConnectorApplicationSetting 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.

Required Parameters

-ServerAddress

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

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional 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
Type:AccessLevelType
Parameter Sets:Allow, Block, Quarantine
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AccessRule
Type:ExchangeConnectorAccessRule[]
Aliases:AccessRules
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:ActiveDirectoryContainers
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowExternalDeviceManagement

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

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

Type:ExchangeConnectorApplicationSetting
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DeltaSyncMins
Type:Int32
Aliases:DeltaSyncInterval
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

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

Specifies an array of email addresses.

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

Type:ExchangeConnectorEmailManagementSetting
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableAccessRule

Indicates whether to enable an access rule.

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

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

Type:Dictionary`2[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FindAll

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

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

Indicates that wildcard handling is enabled.

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

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

Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Type:ExchangeConnectorGeneralSetting
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsHosted

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

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaximumInactiveDays
Type:Int32
Aliases:MaximumInactiveDay
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewServerAddress

Specifies a new server address for an Exchange server.

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

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

  • DevicePasswordEnabled
  • DevicePasswordExpiration
  • DevicePasswordHistory
  • MaxDevicePasswordFailedAttempts
  • PasswordRecoveryEnabled
  • MinDevicePasswordComplexCharacters
  • MinDevicePasswordLength
  • AlphanumericDevicePasswordRequired
  • AllowSimpleDevicePassword
Type:ExchangeConnectorPasswordSetting
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Type:ExchangeConnectorSecuritySetting
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the Exchange Server by using a site code.

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

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

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