Set-CsDialInConferencingAccessNumber
Ultima modifica dell'argomento: 2012-03-27
Modifica i valori delle proprietà di un numero di accesso a conferenze telefoniche con accesso esterno. Le conferenze telefoniche con accesso esterno consentono agli utenti di utilizzare un normale telefono, un telefono cellulare o un altro dispositivo nella rete PSTN (Public Switched Telephone Network) per partecipare alla parte audio di una conferenza.
Sintassi
Set-CsDialInConferencingAccessNumber -Instance <AccessNumber> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineUri <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-Regions <MultiValuedProperty>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> -Priority <Int32> -ReorderedRegion <String> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-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. In questo modo, anche gli utenti che non dispongono di un computer o di una connessione Internet possono partecipare alla riunione. Gli utenti telefonici dispongono delle funzionalità audio complete: possono parlare ad altri partecipanti e ascoltare tutto ciò che accade; non sono però in grado di vedere diapositive, video o altri contributi visivi.
Per offrire agli utenti le funzionalità delle conferenze telefoniche con accesso esterno, è necessario creare numeri di accesso alle conferenze telefoniche con accesso esterno, ovvero numeri di telefono che gli utenti possono comporre per collegarsi a una riunione. I numeri di accesso alle conferenze telefoniche con accesso esterno vengono creati utilizzando il cmdlet New-CsDialInConferencingAccessNumber. Quando viene creato un nuovo numero di accesso a conferenze telefoniche con accesso esterno, di fatto viene creato un nuovo oggetto contatto in Servizi di dominio Active Directory. Questo oggetto contatto viene utilizzato per rappresentare il numero di accesso e tutte le relative proprietà.
Dopo aver creato un numero di accesso, è possibile utilizzare il cmdlet Set-CsDialInConferencingAccessNumber per modificarne le proprietà. Ad esempio, è possibile cambiare il numero di telefono stesso (LineUri) o il nome visualizzato dell'oggetto contatto che rappresenta il numero. Inoltre, Set-CsDialInConferencingAccessNumber consente di modificare l'ambito del numero. Ad esempio, è possibile utilizzare questo cmdlet per riassegnare all'ambito del sito un numero che è stato assegnato all'ambito globale.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsDialInConferencingAccessNumber può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialInConferencingAccessNumber"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Indirizzo SIP |
L'indirizzo SIP dell'oggetto contatto che rappresenta il numero di conferenza telefonica con accesso esterno. Quando si specifica l'identità, è necessario includere il prefisso "sip:"; ad esempio: -Identity " sip:RedmondDialIn@litwareinc.com". |
Instance |
Facoltativo |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
|
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 sulla pagina Impostazioni conferenza telefonica con accesso esterno. È possibile formattare la proprietà DisplayNumber a propria discrezione: ad esempio, 1-800-555-1234; 1-(800)-555-1234; o 1.800.555.1234. |
LineUri |
Facoltativo |
Stringa |
Numero di telefono della conferenza telefonica con accesso esterno. Specificare il LineUri utilizzando la seguente sintassi: il prefisso tel: seguito dal segno più (+) seguito dal prefisso internazionale, dal prefisso locale e dal numero telefonico. Ad esempio: tel:+18005551234. Si noti che non sono consentiti spazi, trattini, parentesi e altri caratteri. |
PassThru |
Facoltativo |
Parametro opzionale |
Consente di passare attraverso la pipeline un oggetto contatto che rappresenta il numero di accesso alla conferenza telefonica con accesso esterno modificato. Per impostazione predefinita, il cmdlet Set-CsDialInConferencingAccessNumber non passa alcun oggetto attraverso la pipeline. |
PrimaryLanguage |
Facoltativo |
Stringa |
Lingua principale utilizzata per gli annunci di conferenza telefonica con accesso esterno. La lingua deve essere configurata utilizzando uno dei codici della lingua disponibili per la conferenza telefonica con accesso esterno, ad esempio, en-US per inglese Stati Uniti o fr-FR per francese. Per visualizzare un elenco dei codici della lingua disponibili, al prompt di Windows PowerShell digitare il comando seguente: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
Priority |
Facoltativo |
Numero intero |
Consente di cambiare l'ordine in cui i numeri di conferenza telefonica con accesso esterno vengono presentati agli utenti negli inviti alle riunioni o quando accedono alla pagina Web Impostazioni conferenza telefonica con accesso esterno. I numeri più bassi hanno una priorità più alta. Per fare in modo che un numero venga visualizzato all'inizio dell'elenco, impostare la priorità su 0. Si noti che, se si modifica la priorità di un determinato numero, è necessario utilizzare anche il parametro ReorderedRegion per indicare l'area in cui la nuova priorità deve essere applicata. |
Regions |
Facoltativo |
Stringa |
Aree di dial plan associate al numero di accesso. Se un'area non è inclusa in almeno un dial plan, non può essere associata a un numero di accesso alla conferenza telefonica con accesso esterno. Per specificare più aree, utilizzare le virgole per separarle: -Regions "Northwest", "Southwest" |
ReorderedRegion |
Facoltativo |
Stringa |
Utilizzato con il parametro Priority quando si cambia la priorità di un numero di conferenza telefonica con accesso esterno in un'area. Il parametro ReorderedRegion indica l'area in cui deve essere applicato il riordino della priorità, ad esempio: -ReorderedRegion "Redmond". |
ScopeToGlobal |
Facoltativo |
Parametro opzionale |
Se presente, il numero di conferenza telefonica con accesso esterno verrà assegnato all'ambito globale. |
ScopeToSite |
Facoltativo |
Parametro opzionale |
Se presente, il numero di conferenza telefonica con accesso esterno verrà assegnato all'ambito del sito in cui risiede il pool di registrazione dell'oggetto contatto. |
SecondaryLanguages |
Facoltativo |
Raccolta di stringhe |
Raccolta facoltativa di lingue utilizzabili per gli annunci della conferenza telefonica con accesso esterno. Le lingue secondarie devono essere configurate sotto forma di elenco di codici delimitati da virgole; ad esempio, la sintassi seguente imposta francese canadese e francese come lingue secondarie: -SecondaryLanguages "fr-CA", "fr-FR". Un numero di accesso può essere associato a un massimo di quattro lingue secondarie. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.Xds.AccessNumber. Set-CsDialInConferencingAccessNumber accetta input tramite pipeline dall'oggetto numero di accesso.
Tipi restituiti
Set-CsDialInConferencingAccessNumber non restituisce alcun oggetto o valore. In realtà, il cmdlet consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.Xds.AccessNumber.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -DisplayName "Redmond Dial-In Access Number"
Il comando riportato nell'esempio 1 consente di modificare la proprietà DisplayName del numero di accesso alla conferenza telefonica con accesso esterno con Identity sip:RedmondDialIn@litwareinc.com. In questo esempio, il nome visualizzato è impostato su "Redmond Dial-In Access Number".
-------------------------- Esempio 2 ------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -Regions "Redmond", "Seattle"
Nell'Esempio 2, il numero di accesso alla conferenza telefonica con accesso esterno con Identity sip:RedmondDialIn@litwareinc.com è stato modificato con l'inclusione di due aree: Redmond e Seattle. Per ottenere questo risultato, viene utilizzato il parametro Region, seguito dalle due aree (due stringhe separate da virgole). Si noti che questo comando avrà esito negativo se le due aree Redmond e Seattle non sono già state definite nei dial plan.
-------------------------- Esempio 3 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"
Nell'esempio precedente, tutti i numeri di accesso alla conferenza telefonica con accesso esterno in cui la lingua principale è francese sono stati modificati con l'impostazione del francese canadese come lingua secondaria. Per eseguire questa operazione, viene prima utilizzato Get-CsDialInConferencingAccessNumber per ottenere una raccolta di tutti i numeri di accesso utilizzati nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei numeri di accesso in cui la proprietà PrimaryLanguage è uguale a francese ("fr-FR"). Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsDialInConferencingAccessNumber che imposta il valore della priorità SecondaryLanguages su francese canadese ("fr-CA").
-------------------------- Esempio 4 ------------------------
Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default DialIn Access Number"} | Set-CsDialInConferencingAccessNumber -DisplayName "Litwareinc Conferencing"
Il comando riportato nell'esempio 4 consente di cambiare il nome visualizzato in Active Directory per il numero di accesso alla conferenza telefonica con accesso esterno. Per ottenere questo risultato, il comando utilizza prima Get-CsDialInConferencingAccessNumber e il parametro Filter per ottenere il numero di accesso in cui la proprietà DisplayName è uguale a "Default DialIn Access Number". Il numero di accesso così ottenuto viene quindi inviato tramite pipe al cmdlet Set-CsDialInConferencingAccessNumber che cambia il nome visualizzato in Litwareinc Conferencing.
-------------------------- Esempio 5 ------------------------
Get-CsDialInConferencingAccessNumber -Filter {LineUri -eq "TEL:+14255558715"} | Set-CsDialInConferencingAccessNumber -DisplayNumber "1-425-555-1298" -LineUri "tel:+14255551298"
Nell'esempio 5, sia il numero visualizzato che l'URI (Uniform Resource Identifier) di linea sono stati modificati in base al numero di accesso specificato. Per recuperare il numero da modificare, il comando prima utilizza Get-CsDialInConferencingAccessNumber e il parametro Filter; il filtro restituisce solo i dati relativi al numero di accesso in cui la proprietà LineUri è uguale a TEL:+14255558715. Il numero di accesso così ottenuto viene quindi inviato tramite pipe al cmdlet Set-CsDialInConferencingAccessNumber che, a sua volta, ne modifica le proprietà DisplayNumber e LineUri.
-------------------------- Esempio 6 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "en-US"} | Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-FR","it-IT"
Il comando precedente assegna una coppia di lingue secondarie a tutti i numeri di accesso che non utilizzano l'inglese americano come lingua principale. Per ottenere questo risultato, il comando prima utilizza il cmdlet Get-CsDialInConferencingAccessNumber per ottenere una raccolta di tutti i numeri di accesso utilizzati nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei numeri in cui la proprietà PrimaryLanguage è uguale a inglese americano (en-US). Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsDialInConferencingAccessNumber che utilizza il parametro SecondaryLanguages per assegnare ciascun numero della raccolta alle lingue secondarie francese (fr-FR) e italiano (it-IT).
-------------------------- Esempio 7 ------------------------
Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond
Il comando riportato nell'esempio 7 assegna al numero di accesso "sip:RedmondDialIn@litwareinc.com" la priorità più alta nell'area di Redmond; questo numero verrà visualizzato per primo negli inviti alle riunioni e sulla pagina Web della conferenza con accesso esterno. Per impostare la priorità, viene utilizzato il parametro Priority con il valore 0. Il numero di accesso con priorità più alta ha il valore 0, il successivo ha il valore 1 e così via. Inoltre, viene incluso il parametro ReorderedRegion per indicare che le priorità dei numeri di accesso devono essere modificate nell'area di Redmond.
Vedere anche
Ulteriori risorse
Get-CsDialInConferencingAccessNumber
New-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber