Export (0) Print
Expand All
Expand Minimize

New-CMExchangeServerConnectorPasswordSetting

Updated: September 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

New-CMExchangeServerConnectorPasswordSetting

Adds new password settings to a Microsoft Exchange Server connector in Configuration Manager.

Syntax

Parameter Set: New
New-CMExchangeServerConnectorPasswordSetting -PasswordEnabled <Boolean> [-AllowSimplePassword <Boolean> ] [-MaximumIdleTimeMinutes <Int32> ] [-MinimumComplexChar <Int32> ] [-MinimumPasswordLength <Int32> ] [-PasswordComplexity <PasswordComplexityType> {Pin | Strong} ] [-PasswordExpiration <Int32> ] [-PasswordHistory <Int32> ] [-PasswordRecovery <Boolean> ] [-WipeAfterFailedAttempt <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The New-CMExchangeServerConnectorPasswordSetting cmdlet adds new password settings to a Microsoft Exchange Server connector in Microsoft System Center 2012 Configuration Manager. An Exchange Server connector in System Center 2012 Configuration Manager manages mobile devices that connect to an on-premise or online Exchange Server by using the Exchange ActiveSync protocol.

Parameters

-AllowSimplePassword<Boolean>

Indicates whether the mobile device can use simple numeric passwords. A simple numeric password is one that has the same offset between each pair of digits. For example, 2468 is a simple password because each pair of digits has an offset of two. Simple numeric passwords can begin or end with 0 but cannot include values that wrap around in the middle of the digit string, such as 6802.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MaximumIdleTimeMinutes<Int32>

Specifies the idle time, in minutes, that must elapse before the mobile device locks itself.

The PasswordEnabled parameter must also have a value of $True for the MaximumIdleTimeMinutes parameter to take effect.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MinimumComplexChar<Int32>

Specifies the minimum number of required complex characters in a device password. A complex character is any character that is not a letter.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MinimumPasswordLength<Int32>

Specifies the minimum number of digits, characters, or both for the password.

The PasswordEnabled parameter must also have a value of $True for the MinimumPasswordLength parameter to take effect. If PasswordEnabled has a value of $True, you can specify a minimum password length of between 1 and 40 characters. If PasswordEnabled is $False, default password lengths apply: four characters for a simple password (AllowSimplePassword set to $True) or seven characters for an alphanumeric password (PasswordComplexityType set to $True).


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordComplexity<PasswordComplexityType>

Specifies the complexity type for the password. The acceptable values for this parameter are:

-- Pin: the password must be numeric.
-- Strong: the password must be alphanumeric.

The PasswordEnabled parameter must also have a value of $True for the PasswordComplexityarameter to take effect.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordEnabled<Boolean>

Indicates whether a user must set a password on the mobile device.

If this parameter is $True, the user must set a password.

If this parameter is $False, users can disable their password by using Control Panel and do not need to lock their Windows Mobile device. However, the device does not inform the user that the password is disabled.

If you do not set a value for the parameter, the password-related settings on the mobile device remain in effect.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordExpiration<Int32>

Specifies the number of days before the password expires and the user must enter a new one.

The PasswordEnabled parameter must also have a value of $True for the PasswordExpiration parameter to take effect. If PasswordExpiration is set to $False, the user can keep the same password indefinitely. If you do not set a value for PasswordExpiration, password expiration settings on the mobile device remain in effect.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordHistory<Int32>

Specifies the number of password changes a user must make before the user can reuse a previous password.

The PasswordEnabled parameter must also have a value of $True for the PasswordHistory parameter to take effect. PasswordExpiration is set to $false, users can reuse any previous password. If you do not set a value for PasswordExpiration, password settings on the mobile device remain in effect.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PasswordRecovery<Boolean>

Indicates whether users can recover a missing device password or PIN from the mobile device. If you do not set a value for this parameter, the password recovery options on the mobile device remain in effect.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-WipeAfterFailedAttempt<Int32>

Specifies the number of failed attempts to reset a password before the device wipes data from itself.


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: Specify password settings for an Exchange Server connector

This command sets these password-related options for an Exchange Server connector:

-- Requires the user to set a password on the mobile device.
-- Requires the password to have at least eight characters or digits.
-- Causes the password to expire after 51 days.
-- Requires 21 password changes before the user can reuse an earlier password.
-- Wipes data from the mobile device after six failed attempts to change the password.
-- Allows 41 minutes to elapse before the mobile device locks itself.
-- Requires an alphanumeric password.
-- Allows passwords to be simple.
-- Allows users to recover missing passwords from the mobile device.


PS C:\> New-CMExchangeServerConnectorPasswordSetting -PasswordEnabled $True -MinimumPasswordLength 8 -PasswordExpiration 51 -PasswordHistory 21 -WipeAfterFailedAttempt 6 -MaximumIdleTimeMinutes 41 -PasswordComplexity Strong -MinimumComplexChar 3 -AllowSimplePassword $true -PasswordRecovery $True

Related topics

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