[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Removes an Auto Attendant or Subscriber Access contact object from hosted Exchange Unified Messaging (UM).

Syntax


Remove-CsExUmContact -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Required	UserIdParameter	The unique identifier of the contact object you want to remove. Contact identities can be specified using one of four formats: 1) The contact’s SIP address; 2) the contact's user principal name (UPN); 3) the contact's domain name and logon name, in the form domain\logon (for example, litwareinc\exum1); and, 4) the contact's Active Directory display name (for example, Team Auto Attendant). Full data type: Microsoft.Rtc.Management.AD.UserIdParameter
Confirm	Optional	SwitchParameter	Prompts you for confirmation before executing the command.
WhatIf	Optional	SwitchParameter	Describes what would happen if you executed the command without actually executing the command.

Parameter

Required

Type

Description

Identity

Required

UserIdParameter

The unique identifier of the contact object you want to remove. Contact identities can be specified using one of four formats: 1) The contact’s SIP address; 2) the contact's user principal name (UPN); 3) the contact's domain name and logon name, in the form domain\logon (for example, litwareinc\exum1); and, 4) the contact's Active Directory display name (for example, Team Auto Attendant).

Full data type: Microsoft.Rtc.Management.AD.UserIdParameter

Confirm

Optional

SwitchParameter

Prompts you for confirmation before executing the command.

WhatIf

Optional

SwitchParameter

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

Detailed Description

Microsoft Communications Server 2010 works with Exchange UM to provide several voice-related capabilities, including Auto Attendant and Subscriber Access. When Exchange UM is provided as a hosted service (rather than on premises), contact objects must be created using PowerShell to apply the Auto Attendant and Subscriber Access functionality. Any of the objects that are created can be removed with the Remove-CsExUmContact cmdlet.

Return Types

This cmdlet does not return an object. It removes an object of type Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Examples

-------------------------- Example 1 --------------------------

	Copy Code
Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com

This example removes the Exchange UM contact with the SIP Address exumsa1@fabrikam.com.

-------------------------- Example 2 --------------------------

	Copy Code
Get-CsExUmContact -Filter {LineURI -like "tel:425*"} \| Remove-CsExUmContact

This example removes all Exchange UM contacts with LineURI values beginning with tel:425. The first part of this command calls the Get-CsExUmContact cmdlet with the Filter parameter, using this expression as the filter: LineURI -like "tel:425*". That filter specifies that we want to retrieve the Exchange UM contact objects that have a LineURI matching the wildcard string tel:425*. In other words, all Line Uris that start with the string tel:425 and end with any set of characters. Once we have that collection of objects, we pipe the collection to the Remove-CsExUmContact cmdlet, which removes all the items in the collection.