Compartilhar via

  • Artigo

New-CsUnassignedNumber

 

Tópico modificado em: 2012-03-26

Cria uma nova série de números não atribuídos e as regras de roteamento que se aplicarem a esses números. A execução deste cmdlet adicionará uma entrada à tabela de roteamento de números não atribuídos.

Sintaxe

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

New-CsUnassignedNumber -Identity <XdsGlobalRelativeIdentity> -NumberRangeStart <String> -NumberRangeEnd <String> -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-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 as chamadas para certos destinos, quando se chamar um número não atribuído. Este cmdlet cria as definições que especificam esse roteamento.

Antes de se executar este cmdlet, é necessário que Announcements já esteja definido no sistema ou que já haja um atendedor automático do Unificação de Mensagens (UM) do Exchange configurado. Para determinar se você possui Comunicados, chame o cmdlet Get-CsAnnouncement. Para criar um novo Comunicado, chame New-CsAnnouncement Para verificar as definições do Atendedor Automático do UM do Exchange, execute o cmdlet Get-CsExUmContact.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsUnassignedNumber localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Um nome exclusivo do intervalo de números não-atribuídos que estão sendo criados. Todos os números não atribuídos têm escopo global, de forma que o nome especificado aqui deve ser exclusivo em toda a implantação do Lync Server 2010

AnnouncementName

Obrigatório

Cadeia de caracteres

O nome do Comunicado que será utilizado para gerenciar as chamadas destinadas a esse intervalo de números.

AnnouncementService

Obrigatório

Cadeia de caracteres

O FQDN (nome de domínio totalmente qualificado) ou ID do serviço de comunicados. Este parâmetro será obrigatório somente se não tiver sido especificado um valor para o parâmetro ExUmAutoAttendantPhoneNumber.

ExUmAutoAttendantPhoneNumber

Obrigatório

Cadeia de caracteres

O número de telefone do Atendedor Automático do UM do Exchange para o qual serão roteadas as chamadas nesse intervalo. Este campo será obrigatório somente se não estiver sendo utilizado um serviço de comunicados (em cujo caso não se fornecem valores para os parâmetros AnnouncementService ou AnnouncementName). O contato do Atendedor Automático do UM do Exchange já deve estar definido, para que se possa atribuir um valor a esse parâmetro.

NumberRangeStart

Obrigatório

Cadeia de caracteres

O primeiro número no intervalo de números não atribuídos. Deve ser menor ou igual ao valor fornecido para NumberRangeEnd.

O número deve corresponder à expressão regular (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Isso significa que o número pode começar com a cadeia de caracteres tel: (se você não especificar essa cadeia de caracteres, ela será adicionada automaticamente), um sinal de adição (+) e um dígito de 1 a 9. O número de telefone pode ter até 17 dígitos e pode ser seguido de um ramal no formato ;ext=, seguido do número do ramal.

NumberRangeEnd

Obrigatório

Cadeia de caracteres

O último número no intervalo de números não atribuídos. Deve ser maior ou igual ao número fornecido para NumberRangeStart. Para especificar um intervalo de um número, use o mesmo número para NumberRangeStart e NumberRangeEnd.

O número deve corresponder à expressão regular (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Isso significa que o número pode começar com a cadeia de caracteres tel: (se você não especificar essa cadeia de caracteres, ela será adicionada automaticamente), um sinal de adição (+) e um dígito de 1 a 9. O número de telefone pode ter até 17 dígitos e pode ser seguido de um ramal no formato ;ext=, seguido do número do ramal.

Priority

Opcional

Int32

É possível que intervalos de números não atribuídos se sobreponham. Se um número estiver dentro de mais de um intervalo, o intervalo com a prioridade mais alta terá efeito.

Force

Opcional

SwitchParameter

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

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Exemplo

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

New-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551100" -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Welcome Announcement"

Este exemplo cria um intervalo de números não atribuídos com o nome UNSet1. Utilizam-se os parâmetros NumberRangeStart (+14255551000) e NumberRangeEnd (+14255551100) para definir o intervalo de números não atribuídos ao qual se aplicará o comunicado especificado. Finalmente, especifica-se o comunicado, primeiramente fornecendo ao parâmetro AnnouncementService o ID do serviço de comunicados e, em seguida, passando-se o valor "Comunicado de Boas-Vindas" para o parâmetro AnnouncementName. Tenha em mente que é necessário que já exista um comunicado com esse nome no sistema.

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

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234"

Este exemplo cria um intervalo de números não atribuídos com o nome UNSet2. Como no Exemplo 1, utilizam-se os parâmetros NumberRangeStart (+14255552100) e NumberRangeEnd (+14255552200) para definir o intervalo de números não atribuídos ao qual se aplicará o comunicado especificado. Contudo, neste exemplo, em vez de usar o serviço de comunicados, este intervalo de números utilizará o atendedor automático do UM do Exchange (o atendedor automático é um número único designado como número principal da organização que orienta os usuários por prompts de voz, ajudando-os a acessarem a parte apropriada). Passa-se o número de telefone para o parâmetro ExUmAutoAttendantPhoneNumber, para concluir este comando. Observe que UM do Exchange deve ser configurado e este número deve ser um número de telefone de contato existente no Serviços de Domínio Active Directory (AD DS). O contato deve ser um contato do Atendedor Automático (a propriedade AutoAttendant do contato deve ser True).

-------------------------- Exemplo 3 --------------------------

New-CsUnassignedNumber -Identity UNSet2 -NumberRangeStart "+14255552100" -NumberRangeEnd "+14255552200" -ExUmAutoAttendantPhoneNumber "+12065551234" -Priority 2

O Exemplo 3 é quase idêntico ao Exemplo 2: ele cria um intervalo de números não atribuídos com o nome UNSet2. A diferença neste exemplo é que adicionou-se o parâmetro Priority, neste caso, com o valor 2. Isto significa que, se um intervalo de números não atribuídos tiver sido definido e se sobrepuser a este e aquele intervalo de números tiver uma prioridade mais alta (um número de prioridade menor, como 1), as chamadas serão encaminhadas com base nas definições daquele intervalo, em vez das definições deste.