Condividi tramite

  • Articolo

New-CsDialInConferencingAccessNumber

 

Ultima modifica dell'argomento: 2012-03-23

Crea un nuovo numero di accesso per la conferenza telefonica con accesso esterno. Le conferenze telefoniche con accesso esterno consentono agli utenti di utilizzare un normale telefono, un cellulare o un altro dispositivo nella rete PSTN per partecipare alla parte audio di una conferenza.

Sintassi

New-CsDialInConferencingAccessNumber -DisplayNumber <String> -LineURI <String> -Pool <Fqdn> -PrimaryLanguage <String> -PrimaryUri <String> -Regions <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-PassThru <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le conferenze telefoniche con accesso esterno consentono agli utenti di utilizzare qualsiasi tipo di telefono, ad esempio una linea terrestre standard, un telefono cellulare o un telefono VoIP (Voice over Internet Protocol), per partecipare alla parte audio di una conferenza online. In questo modo è possibile partecipare alla riunione anche non disponendo di un computer o di una connessione Internet. Gli utenti dispongono delle funzionalità audio complete: possono parlare con altri partecipanti e ascoltare tutto. Non sono invece in grado di visualizzare diapositive condivise, trasmissioni video o altri elementi visivi.

Per offrire agli utenti le funzionalità di conferenza telefonica con accesso esterno, è necessario creare numeri di accesso alle conferenze telefoniche con accesso esterno, ovvero dei numeri telefonici che gli utenti chiamano per collegarsi alla riunione. I numeri di accesso alle conferenze telefoniche con accesso esterno vengono creati utilizzando il cmdlet New-CsDialInConferencingAccessNumber. Quando si crea un nuovo numero di accesso alle conferenze telefoniche con accesso esterno, si crea in realtà un nuovo oggetto contatto in Servizi di dominio Active Directory. L'oggetto contatto viene utilizzato per rappresentare il numero di accesso e tutte le relative proprietà.

Durante la creazione di un nuovo numero telefonico con accesso esterno, è necessario includere i seguenti parametri: PrimaryUri, LineURI, Pool, DisplayNumber, PrimaryLanguage e Regions. Tutti questi parametri e i rispettivi valori risultano abbastanza immediati, probabilmente con una sola eccezione, ovvero Regions. Quando si crea un nuovo numero di accesso, questo numero deve essere associato a una o più aree. A sua volta, un'area non può essere associata a un numero di conferenza telefonica ad accesso esterno, purché l'area non compaia almeno in un dial plan. Se un'area compare nella proprietà DialInConferencingRegion di almeno un dial plan, può essere associata a un numero di accesso. In caso contrario, non può essere associata a un numero di accesso. Ciò significa semplicemente che è necessario innanzitutto creare un dial plan e specificare un'area corrispondente per poter creare un numero di accesso a una conferenza telefonica con accesso esterno.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsDialInConferencingAccessNumber 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 "New-CsDialInConferencingAccessNumber"}

Parametri

Parametro Obbligatorio Tipo Descrizione

PrimaryUri

Obbligatorio

Indirizzo SIP

Indirizzo SIP univoco da assegnare al nuovo oggetto contatto. Quando si specifica il parametro PrimaryUri, è necessario includere il prefisso "sip:" "sip:", ad esempio -PrimaryUri "sip:RedmondDialIn@litwareinc.com".

DisplayName

Facoltativo

Stringa

Nome visualizzato in Active Directory per il nuovo oggetto contatto. Si tratta del nome che verrà visualizzato anche in Microsoft Lync 2010.

DisplayNumber

Obbligatorio

Stringa

Numero di telefono visualizzato negli inviti alle riunioni e nella pagina Web della conferenza telefonica con accesso esterno. È possibile formattare la proprietà DisplayNumber a propria discrezione, ad esempio 1-800-555-1234, 1-(800)-555-1234 oppure 1.800.555.1234.

LineURI

Obbligatorio

Stringa

Il numero effettivo della conferenza telefonica ad accesso esterno. Specificare il parametro LineURI utilizzando la seguente sintassi: il prefisso tel: seguito dal segno più (+), a sua volta seguito dal codice paese, dall'indicativo di località e dal numero di telefono. Ad esempio: tel:+18005551234. Spazi, trattini, parentesi e altri caratteri non sono consentiti.

I parametri LineURI devono essere univoci nell'ambito di Active Directory.

Regions

Obbligatorio

Stringa

Aree dei dial plan associate al numero telefonico con accesso esterno. Se l'area non è inclusa in almeno un dial plan, non può essere associata a un numero di accesso per conferenze telefoniche con accesso esterno. Per specificare più aree, utilizzare un elenco separato da virgole: -Regions "Northwest", "Southwest"

Pool

Obbligatorio

FQDN

Pool principale del nuovo oggetto contatto.

PrimaryLanguage

Obbligatorio

Stringa

Lingua principale utilizzata per gli annunci delle conferenze telefoniche ad accesso esterno. La lingua deve essere configurata utilizzando uno dei codici lingua per conferenze telefoniche con accesso esterno disponibili, ad esempio en-US per l'inglese americano, fr-FR per il francese e così via. Per restituire un elenco dei codici lingua disponibili, al prompt di Windows PowerShell digitare il seguente comando:

Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages.

SecondaryLanguages

Facoltativo

Matrice di stringhe

Raccolta facoltativa di lingue che è possibile utilizzare per gli annunci delle conferenze telefoniche con accesso esterno. Le lingue secondarie devono essere configurate come un elenco di codici lingua delimitati da virgole; ad esempio, la sintassi riportata di seguito imposta il francese canadese e il francese come lingue secondarie: -SecondaryLanguages "fr-CA", "fr-FR".

Per un singolo numero di accesso possono esistere un massimo di quattro lingue secondarie.

ScopeToSite

Facoltativo

Parametro opzionale

Se presente, il nuovo numero verrà assegnato allo stesso sito del pool principale dell'oggetto contatto. Se il parametro ScopeToSite non è incluso, il nuovo numero verrà assegnato all'ambito globale.

PassThru

Facoltativo

Parametro opzionale

Consente di passare attraverso la pipeline un oggetto contatto che rappresenta il nuovo numero di accesso alla conferenza telefonica ad accesso esterno. Per impostazione predefinita, il cmdlet New-CsDialInConferencingAccessNumber non passa alcun oggetto attraverso la pipeline.

Tenant

Facoltativo

GUID

Questo parametro non è applicabile alla versione locale di Lync Server 2010.

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

Nessuno. New-CsDialInConferencingAccessNumber non accetta l'input da pipeline.

Tipi restituiti

New-CsDialInConferencingAccessNumber crea nuove istanze dell'oggetto Microsoft.Rtc.Management.Xds.AccessNumber.

Esempio

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

New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond"

Nell'esempio 1 viene creato un nuovo numero di accesso per conferenze telefoniche con accesso esterno con URI primario sip:RedmondDialIn@litwareinc.com. Oltre al parametro PrimaryUri, il comando include anche i parametri che configurano il numero di telefono visualizzato in Microsoft Lync 2010 (DisplayNumber), il numero di telefono nel formato E.164 (LineUri), il pool di registrazione a cui è assegnato il nuovo numero (-Pool), la lingua principale del numero (PrimaryLanguage) e l'area a cui è assegnato il numero (Regions).

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

New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond" -SecondaryLanguages "fr-CA", "fr-FR"

Il comando mostrato nell'esempio 2 è una variazione del comando nell'esempio 1, con la sola differenza che il comando mostrato in questo esempio assegna anche due lingue secondarie (francese canadese e francese) al nuovo numero di accesso alla conferenza telefonica con accesso esterno. Per assegnare queste lingue secondarie, viene incluso il parametro SecondaryLanguages insieme a un elenco con valori delimitati da virgole contenente le lingue da assegnare (fr-CA e fr-FR).

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

New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond" -ScopeToSite

Con il comando precedente viene creato un nuovo numero di accesso per conferenze telefoniche con accesso esterno nell'ambito del sito in cui è contenuto il pool principale dell'oggetto contatto. A tale scopo, il comando include il parametro ScopeToSite.