Compartilhar via

  • Artigo

Remove-CsExUmContact

 

Tópico modificado em: 2012-03-25

Remove um contato do Acesso de assinante ou do Atendedor automático do Unificação de Mensagens (UM) do Exchange hospedado.

Sintaxe

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

Descrição Detalhada

O Microsoft Lync Server 2010 funciona em conjunto com o UM do Exchange para fornecer várias capacidades relacionadas à voz, incluindo o Atendedor Automático e o Acesso de Assinante. Quando se fornece o UM do Exchange como um serviço hospedado (e não em uma implementação local), os objetos de contato devem ser criados usando-se Windows PowerShell, para aplicar a funcionalidade do Acesso de assinante e do Atendedor automático. Quaisquer um dos objetos criados podem ser removidos com o cmdlet Remove-CsExUmContact.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsExUmContact localmente: RTCUniversalUserAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsExUmContact"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

O identificador exclusivo do objeto de contato que se deseja remover. As Identidades de contato podem ser especificadas usando um de quatro formatos: 1) O endereço SIP do contato, 2) o Nome Principal Universal do usuário (UPN), 3) o nome de domínio do contato e nome de logon, na forma domínio\logon (por exemplo, litwareinc\exum1) e 4) o nome de exibição do Active Directory do contato (por exemplo, Atendedor Automático da Equipe).

Tipo de dados completos: Microsoft.Rtc.Management.AD.UserIdParameter

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact. Aceita entradas canalizadas dos objetos de contato do UM do Exchange.

Tipos de Retorno

Este cmdlet não retorna um objeto. Remove um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Exemplo

-------------------------- Exemplo 1 --------------------------

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

Este exemplo remove o contato UM do Exchange com o endereço SIP exumsa1@fabrikam.com.

-------------------------- Exemplo 2 --------------------------

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

Este exemplo remove todos os contatos do UM do Exchange cujos valores LineURI forem iniciados por 425. A primeira parte deste comando chama o cmdlet Get-CsExUmContact com o parâmetro Filter, usando esta expressão como o filtro: LineURI -like "tel:425*". O filtro especifica que desejamos recuperar os objetos de contato do UM do Exchange que tiverem uma LineURI correspondente à cadeia de caracteres curinga 425\*. Em outras palavras, todos os URIs da linha que forem iniciados pela cadeia de caracteres 425 e terminarem com qualquer conjunto de caracteres. Assim que essa coleção de objetos for apresentada, ela será canalizada para o cmdlet Remove-CsExUmContact, que removerá todos os seus itens.