Compartilhar via

  • Artigo

Get-CsUnassignedNumber

 

Tópico modificado em: 2012-03-23

Recupera um ou vários intervalos de números não atribuídos e as regras de roteamento que se aplicarem a esses números.

Sintaxe

Get-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUnassignedNumber [-Filter <String>] [-LocalStore <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. Esse cmdlet recupera um ou vários intervalos de números não atribuídos que definem esse roteamento.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsUnassignedNumber localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmin. 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 "Get-CsUnassignedNumber"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O nome exclusivo do intervalo de números não atribuídos a ser recuperado.

Filter

Opcional

Cadeia de caracteres

Executa uma pesquisa de caracteres curinga, que permite restringir os seus resultados apenas às definições de números não atribuídos cujas Identidades corresponderem à cadeia de caracteres curingas fornecida.

LocalStore

Opcional

SwitchParameter

Recupera as informações de número não atribuído na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

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

Exemplo

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

Get-CsUnassignedNumber

O Exemplo 1 retorna uma coleção de todos os números não atribuídos configurados para uso em sua organização.

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

Get-CsUnassignedNumber -Identity UNSet1

No Exemplo 2, o parâmetro Identidade é usado para limitar os dados recuperados a números não atribuídos que possuem a Identidade UNSet1. Como as identidades devem ser exclusivas, este comando retornará somente o intervalo especificado de números não atribuídos.

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

Get-CsUnassignedNumber -Filter *Redmond*

Esse exemplo usa o parâmetro Filtro para retornar uma coleção de todas as definições de números não atribuídos com valores de Identidade que incluírem a cadeia de caracteres Redmond. Por exemplo, esse comando retorna uma definição de números não atribuídos com identidades como Redmond Numbers, Unassigned Redmond Numbers, UNRedmond, etc.

-------------------------- Exemplo 4 --------------------------

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

No Exemplo 4, Get-CsUnassignedNumber e Where-Object são usados para recuperar uma coleção de todas as definições de números não atribuídos que incluírem a palavra Welcome no nome do Comunicado. Para fazer isso, o comando usa primeiro Get-CsUnassignedNumber, para recuperar todas as definições de números não atribuídos. Esta coleção será então canalizada para Where-Object, que aplicará um filtro que limita os dados retornados a números não atribuídos contendo a palavra Welcome em alguma posição do nome do comunicado atribuído.