Compartilhar via

  • Artigo

Set-CsUnassignedNumber

 

Tópico modificado em: 2012-03-26

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

Sintaxe

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -ExUmAutoAttendantPhoneNumber <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

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

Set-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-NumberRangeStart <String>] [-NumberRangeEnd <String>] -AnnouncementService <String> -AnnouncementName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsUnassignedNumber [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 chamadas para certos destinos, quando se chamar um número não atribuído. Este cmdlet modifica as definições que especificam esse roteamento.

Para modificar algumas das definições desse cmdlet, é necessário que Comunicados já esteja definido no sistema ou que 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 são autorizados a executar o cmdlet Set-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 "Set-CsUnassignedNumber"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

O nome exclusivo do intervalo de números não-atribuídos que estão sendo modificados.

Instance

Opcional

DisplayAnnouncementVacantNumberRange

Uma referência a um objeto que contém definições de números não-atribuídos. Este objeto deve ser do tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange e pode ser recuperado chamando-se o cmdlet Get-CsUnassignedNumber.

AnnouncementName

Obrigatório

Cadeia de caracteres

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

AnnouncementService

Obrigatório

Cadeia de caracteres

O nome de domínio totalmente qualificado (FQDN) ou ID do serviço do servidor de Comunicados.

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. 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

Opcional

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.

Os números devem 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

Opcional

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.

Os números devem 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 para você), 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.

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. Modifica um objeto do tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Exemplo

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

Set-CsUnassignedNumber -Identity UNSet1 -NumberRangeStart "+14255551000" -NumberRangeEnd "+14255551900"

Esse exemplo modifica o intervalo de número não-atribuído cujo nome for UNSet1. Primeiro, passamos para o parâmetro Identity o valor UNSet1, o nome do intervalo de números atribuídos que queremos modificar. Utilizam-se os parâmetros NumberRangeStart (+14255551000) e NumberRangeEnd (+14255551900) para modificar o intervalo de números não atribuídos ao qual se aplicará o comunicado ou o Atendedor Automático especificado.

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

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"} | Set-CsUnassignedNumber -AnnouncementService ApplicationServer:redmond.litwareinc.com -AnnouncementName "Help Desk Announcement"

Esse exemplo modifica o Comunicado de todas as definições de intervalo de números não-atribuídos que possuírem um Comunicado com a cadeia de caracteres "Bem-vindo" no nome. Primeiramente, chama-se Get-CsUnassignedNumber para recuperar todas as definições de números não-atribuídos. Canalizamos essa coleção de definições para Where-Object, que restringe a coleção apenas às definições cuja propriedade AnnouncementName contiver (-match) a cadeia de caracteres Bem-vindo. Assim que essas definições forem recuperadas, serão canalizadas para Set-CsUnassignedNumber, no qual o ID do Servidor de Aplicativos do Serviço de comunicados (ApplicationServer:redmond.litwareinc.com) será modificado pelo parâmetro AnnouncementService, e o nome do novo comunicado (Comunicado da assistência técnica) pelo parâmetro AnnouncementName. Observe que mesmo se o novo Comunicado tiver um nome diferente mas o mesmo ID de serviço, será necessário especificar o ID do serviço juntamente com o nome.