Compartilhar via

  • Artigo

Remove-CsUnassignedNumber

 

Tópico modificado em: 2012-03-26

Remove um intervalo existente de números não atribuídos e as regras de roteamento que se aplicarem a esses números.

Sintaxe

Remove-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Os números não atribuídos são números de telefone que foram atribuídos a uma organização, mas não a usuários ou telefones específicos. É possível especificar que Microsoft Lync Server 2010 encaminhe chamadas para certos destinos, quando se chamar um número não atribuído. Este cmdlet remove as definições que especificam esse roteamento.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsUnassignedNumber localmente: RTCUniversalServerAdmins. 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 (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

O nome exclusivo do intervalo de números não atribuídos que se deseja remover.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

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.Voice.Helpers.DisplayAnnouncementVacantNumberRange. Aceita entradas canalizadas de objetos de números não atribuídos.

Tipos de Retorno

Este cmdlet não retorna um valor. Remove um objeto do tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Exemplo

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

Remove-CsUnassignedNumber -Identity UNSet1

Neste exemplo, são removidas as definições do número não atribuído cuja identidade for UNSet1.

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

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Remove-CsUnassignedNumber

O Exemplo 2 remove todas as definições de número não atribuído cujo nome do anúncio atribuído contiver a cadeia de caracteres Welcome. O comando inicialmente chama Get-CsUnassignedNumber, que retorna uma coleção de todas as definições de números não atribuídos. Esta coleção será então passada ao cmdlet Where-Object, que restringe a coleção apenas às definições de números não atribuídos cujo AnnouncementName incluir (-match) a cadeia de caracteres Welcome. Finalmente, a coleção restrita será passada para Remove-CsUnassignedNumber, que removerá tudo o que tiver restado na coleção.