Export (0) Print
Expand All
Expand Minimize

Set-CMExchangeServer

Updated: September 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

Set-CMExchangeServer

Changes settings for an Exchange server.

Syntax

Parameter Set: SetBySiteCode
Set-CMExchangeServer -ServerAddress <String> -SiteCode <String> [-AccessLevel <AccessLevelType> {Allow | Block | Quarantine} ] [-AccessRuleString <String[]> ] [-ActiveDirectoryContainer <String[]> ] [-AllowExternalDeviceManagement <Boolean> ] [-ApplicationSetting <Dictionary<String><String>> ] [-DeltaSyncInterval <Int32> ] [-EmailAddress <String[]> ] [-EmailManagementSetting <Dictionary<String><String>> ] [-EnableAccessRule <Boolean> ] [-ExchangeClientAccessServer <Dictionary[]<String><String>> ] [-FindAll] [-FullSyncSchedule <IResultObject> ] [-GeneralSetting <Dictionary<String><String>> ] [-IsHosted] [-MaximumInactiveDay <Int32> ] [-NewServerAddress <String> ] [-PasswordSetting <Dictionary<String><String>> ] [-SecuritySetting <Dictionary<String><String>> ] [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

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

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

Parameters

-AccessLevel<AccessLevelType>

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

-- Allow
-- Block
-- Quarantine


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AccessRuleString<String[]>

Specifies an array of access rules. Access rules control whether a mobile device can access an Exchange server. Access rules apply to a family of devices.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ActiveDirectoryContainer<String[]>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-AllowExternalDeviceManagement<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ApplicationSetting<Dictionary<String><String>>

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. Settings you can specify for this parameter include: AllowUnsignedApplications, AllowUnsignedInstallationPackages, or Block a specific application.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeltaSyncInterval<Int32>

Specifies the interval, in minutes, at which the Exchange Server connector runs delta discovery. Delta discovery looks for new devices or changes to existing devices.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EmailAddress<String[]>

Specifies an array of email addresses.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EmailManagementSetting<Dictionary<String><String>>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableAccessRule<Boolean>

Indicates whether to enable an access rule.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ExchangeClientAccessServer<Dictionary[]<String><String>>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FindAll

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FullSyncSchedule<IResultObject>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GeneralSetting<Dictionary<String><String>>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-IsHosted

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MaximumInactiveDay<Int32>

Specifies the interval between times that the Exchange Server connector runs device discovery. The cmdlet checks the last sync time of the devices that Exchange Server manages.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NewServerAddress<String>

Specifies a new server address for an Exchange server.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordSetting<Dictionary<String><String>>

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

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecuritySetting<Dictionary<String><String>>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ServerAddress<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies the Exchange Server by using a site code.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserName<String>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Change settings for an Exchange server

This example changes the settings for an Exchange server.

The first command uses the New-CMExchangeServerConnectorGeneralSetting cmdlet to add new settings to a Microsoft 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 a Microsoft 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 a Microsoft 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 a Microsoft Exchange Server connector, and stores the application settings in the $As variable.

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


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 "ElizaRodriquez@contoso.com" -DeltaSyncInterval 124 -MaximumInactiveDay 26 -FindAll -AllowExternalDeviceManagement $False -EnableAccessRule $True -AccessLevel Allow -EmailAddress "Ingridhayes@fabrikam.com","IrwinHume@contosco.com" -GeneralSetting $Gs -PasswordSetting $Ps -EmailManagementSetting $Em -SecuritySetting $Ss -ApplicationSetting $As

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft