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"