New-CMExchangeServer

New-CMExchangeServer

Configures a new Exchange Server connector.

Syntax

Parameter Set: New
New-CMExchangeServer -DeltaSyncInterval <Int32> -FullSyncSchedule <IResultObject> -ServerAddress <String> -SiteCode <String> [-ActiveDirectoryContainer <String[]> ] [-AllowExternalDeviceManagement <Boolean> ] [-ApplicationSetting <Dictionary<String>> ] [-EmailManagementSetting <Dictionary<String>> ] [-ExchangeClientAccessServer <Dictionary[]<String>> ] [-GeneralSetting <Dictionary<String>> ] [-MaximumInactiveDay <Int32> ] [-PasswordSetting <Dictionary<String>> ] [-SecuritySetting <Dictionary<String>> ] [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewWithIsHostedES
New-CMExchangeServer -DeltaSyncInterval <Int32> -FullSyncSchedule <IResultObject> -IsHosted -ServerAddress <String> -SiteCode <String> [-ActiveDirectoryContainer <String[]> ] [-AllowExternalDeviceManagement <Boolean> ] [-ApplicationSetting <Dictionary<String>> ] [-EmailManagementSetting <Dictionary<String>> ] [-GeneralSetting <Dictionary<String>> ] [-MaximumInactiveDay <Int32> ] [-PasswordSetting <Dictionary<String>> ] [-SecuritySetting <Dictionary<String>> ] [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The New-CMExchangeServer cmdlet configures a new Microsoft Exchange Server connector in Microsoft System Center 2012 SP1 Configuration Manager. An Exchange Server connector synchronizes and manages the device enrolled by the Exchange Server. For more information, see Configuration Manager 2012 Exchange Connector Implementation in Microsoft IT (https://go.microsoft.com/fwlink/?LinkId=286314) on TechNet.

Parameters

-ActiveDirectoryContainer<String[]>

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

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

Specifies application settings. For each dictionary entry in the array, specify the setting name as the key and the configuration as the value. The acceptable values for this parameter are: 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.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EmailManagementSetting<Dictionary<String>>

Specifies email management settings. 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

-ExchangeClientAccessServer<Dictionary[]<String>>

Specifies an array of 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

-FullSyncSchedule<IResultObject>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GeneralSetting<Dictionary<String>>

Specifies general settings. The acceptable values for this parameter are:

-- 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?

true

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. If the most recent sync time is older than the current time - MinimumInactiveDay, then the exchange connector does not discover the devices.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordSetting<Dictionary<String>>

Specifies password settings. The acceptable values for this parameter are:

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

Specifies a dictionary of security settings. The acceptable values for this parameter are:

-- 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 site code of the Configuration Manager site where a Exchange Server connector runs.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserName<String>

Specifies the username 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 running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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: Create an Exchange Server

These commands create an Exchange Server with the server address http://exchange,contoso.com. To do this, the first command in the example uses the New-CMSchedule cmdlet to create a schedule for doing Exchange synchronizations. This schedule object is stored in a variable $schedule.

The second command then uses New-CMExchangeServer to create the new server as part of the site ContosoSite.

PS C:\> $schedule = New-CMSchedule -Start "03/01/2016 11:59 PM" -RecurInterval Days -RecurCount 1
New-CMExchangeServer -ServerAddress "http://exchange.contoso.com" -DeltaSyncInterval 120 -FullSyncSchedule $schedule -IsHosted -SiteCode "ContosoSite"

Get-CMExchangeServer

Remove-CMExchangeServer

Set-CMExchangeServer

Sync-CMExchangeServer