Condividi tramite

  • Articolo

Set-CsUnassignedNumber

 

Ultima modifica dell'argomento: 2012-03-26

Modifica un intervallo esistente di numeri non assegnati e le regole di routing applicate a tali numeri.

Sintassi

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

Descrizione dettagliata

I numeri non assegnati sono numeri di telefono che sono stati assegnati a un'organizzazione, ma che non sono stati assegnati a utenti o telefoni specifici. Microsoft Lync Server 2010 può essere configurato per instradare le chiamate alle destinazioni appropriate quando viene chiamato un numero non assegnato. Il cmdlet consente di modificare le impostazioni che definiscono tale routing.

Per poter modificare alcune delle impostazioni per il cmdlet, è necessario che nel sistema siano già stati definiti annunci oppure che sia configurato un operatore automatico di Messaggistica unificata di Exchange. Per determinare se sono presenti annunci, chiamare il cmdlet Get-CsAnnouncement. Per creare un nuovo annuncio, chiamare New-CsAnnouncement. Per verificare le impostazioni dell'operatore automatico di Messaggistica unificata di Exchange, eseguire il cmdlet Get-CsExUmContact.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsUnassignedNumber i membri dei seguenti gruppi: RTCUniversalServerAdmins. 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 "Set-CsUnassignedNumber"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Il nome univoco per l'intervallo di numeri non assegnati da modificare.

Instance

Facoltativo

DisplayAnnouncementVacantNumberRange

Un riferimento a un oggetto che contiene le impostazioni dei numeri non assegnati. L'oggetto deve essere di tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange e può essere recuperato chiamando il cmdlet Get-CsUnassignedNumber.

AnnouncementName

Obbligatorio

Stringa

Il nome dell'Annuncio che verrà usato per gestire le chiamate a questo intervallo di numeri.

AnnouncementService

Obbligatorio

Stringa

Il nome di dominio completo (FQDN) o l'ID del servizio del server degli annunci.

ExUmAutoAttendantPhoneNumber

Obbligatorio

Stringa

Il numero di telefono dell'operatore automatico di Messaggistica unificata di Exchange a cui instradare le chiamate comprese nell'intervallo. Il contatto dell'operatore automatico di Messaggistica unificata di Exchange deve essere già configurato per poter assegnare un valore a tale parametro.

NumberRangeStart

Facoltativo

Stringa

Il primo numero nell'intervallo di numeri non assegnati. Il valore deve essere minore o uguale al valore fornito per NumberRangeEnd.

Il numero deve corrispondere all'espressione regolare (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Ciò significa che il valore può iniziare con la stringa tel: (se questa non viene specificata, verrà aggiunta automaticamente), un segno più (+) e una cifra compresa tra 1 e 9. Il numero di telefono può contenere fino a 17 cifre e può essere seguito da un interno nel formato ;ext= seguito dal numero dell'interno.

NumberRangeEnd

Facoltativo

Stringa

L'ultimo numero dell'intervallo di numeri non assegnati. Il valore deve essere maggiore o uguale al numero fornito per NumberRangeStart. Per specificare un intervallo di un numero, utilizzare lo stesso numero per NumberRangeStart e NumberRangeEnd.

Il numero deve corrispondere all'espressione regolare (tel:)?(\+)?[1-9]\d{0,17}(;ext=[1-9]\d{0,9})?. Ciò significa che il valore può iniziare con la stringa tel: (se questa non viene specificata, verrà aggiunta automaticamente), un segno più (+) e una cifra compresa tra 1 e 9. Il numero di telefono può contenere fino a 17 cifre e può essere seguito da un interno nel formato ;ext= seguito dal numero dell'interno.

Priority

Facoltativo

Int32

È possibile sovrapporre intervalli di numeri non assegnati. Se un numero rientra in più di un intervallo, avrà effetto l'intervallo con la priorità più alta.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange. Accetta l'input da pipeline di oggetti numero non assegnato.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di modificare un oggetto di tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Esempio

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

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

Nell'esempio viene modificato l'intervallo di numeri non assegnati con il nome UNSet1. Al parametro Identity viene innanzitutto passato il valore UNSet1, ovvero il nome dell'intervallo di numeri non assegnati che si desidera modificare. Vengono quindi utilizzati i parametri NumberRangeStart (+14255551000) e NumberRangeEnd (+14255551900) per modificare l'intervallo di numeri non assegnati a cui si applicherà l'operatore automatico o l'annuncio specificato.

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

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

Nell'esempio viene modificato l'Annuncio di tutte le impostazioni dell'intervallo di numeri non assegnati che attualmente presentano un Annuncio con la stringa "Welcome" nel nome. Viene innanzitutto chiamato il cmdlet Get-CsUnassignedNumber per recuperare tutte le impostazioni dei numeri non assegnati. La raccolta di impostazioni viene quindi inviata tramite pipe a Where-Object, che circoscrive la raccolta alle sole impostazioni nella cui proprietà AnnouncementName è contenuta (-match) la stringa Welcome. Una volta ottenute, tali impostazioni vengono inviate tramite pipe a Set-CsUnassignedNumber, dove l'ID del server applicazioni del servizio annunci (ApplicationServer:redmond.litwareinc.com) viene modificato con il parametro AnnouncementService e il nome del nuovo annuncio (Help Desk Announcement) viene modificato con il parametro AnnouncementName. Se il nuovo Annuncio ha un nome diverso ma lo stesso ID del servizio, è necessario specificare l'ID del servizio oltre al nome.