Condividi tramite

  • Articolo

Get-CsUnassignedNumber

 

Ultima modifica dell'argomento: 2012-03-23

Recupera uno o più intervalli di numeri non assegnati e le regole di routing applicabili a tali numeri.

Sintassi

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

Get-CsUnassignedNumber [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

I numeri non assegnati sono numeri di telefono che sono stati assegnati a un'organizzazione ma non a utenti o telefoni specifici. È possibile configurare Microsoft Lync Server 2010 in modo da instradare le chiamate a destinazioni appropriate quando viene chiamato un numero non assegnato. Questo cmdlet recupera uno o più intervalli di numeri non assegnati che definiscono questo routing.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsUnassignedNumber i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

Il nome univoco dell'intervallo di numeri non assegnati da recuperare.

Filter

Facoltativo

Stringa

Esegue una ricerca con caratteri jolly che consente di limitare i risultati unicamente alle impostazioni dei numeri non assegnati le cui identità corrispondono alla stringa con caratteri jolly data.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni relative ai numeri non assegnati dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Restituisce un oggetto di tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Esempio

-------------------------- Esempio 1 --------------------------

Get-CsUnassignedNumber

Nell'esempio 1 viene restituita una raccolta di tutti i numeri non assegnati configurati per l'utilizzo nell'organizzazione.

-------------------------- Esempio 2 --------------------------

Get-CsUnassignedNumber -Identity UNSet1

Nell'esempio 2 il parametro Identity viene utilizzato per limitare i dati restituiti ai numeri non assegnati con Identity UNSet1. Poiché le identità devono essere univoche, il comando restituirà solo l'intervallo di numeri non assegnati specificato.

-------------------------- Esempio 3 --------------------------

Get-CsUnassignedNumber -Filter *Redmond*

In questo esempio viene utilizzato il parametro Filter per restituire una raccolta di tutte le impostazioni di numeri non assegnati il cui valore Identity include la stringa Redmond. Ad esempio, questo comando restituisce le impostazioni dei numeri non assegnati con identità, quali Redmond Numbers, Unassigned Redmond Numbers, UNRedmond, ecc.

-------------------------- Esempio 4 --------------------------

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

Nell'esempio 4 vengono utilizzati Get-CsUnassignedNumber e Where-Object per recuperare una raccolta di tutte le impostazioni di numeri non assegnati che includono la parola Welcome nel nome dell'annuncio. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsUnassignedNumber per recuperare tutte le impostazioni dei numeri non assegnati. La raccolta viene quindi inviata tramite pipe a Where-Object, che applica un filtro che limita i dati restituiti ai numeri non assegnati che contengono la parola Welcome nel nome dell'annuncio assegnato.