Condividi tramite

  • Articolo

Set-CsLocationPolicy

 

Ultima modifica dell'argomento: 2012-03-26

Modifica un criterio percorso esistente.

Sintassi

Set-CsLocationPolicy [-Identity <XdsIdentity>] [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il criterio percorso consente di applicare impostazioni relative alla funzionalità per chiamate di emergenza e alla posizione del client. Determina infatti se un utente è abilitato per le chiamate di emergenza e, in tal caso, qual è il comportamento di una chiamata di emergenza. Ad esempio, è possibile utilizzare il criterio percorso per definire il numero che rappresenta una chiamata di emergenza (112 in Italia), per specificare se l'ufficio che si occupa della sicurezza aziendale deve essere avvisato automaticamente e per impostare la modalità di instradamento della chiamata. Questo cmdlet consente di modificare un criterio percorso esistente.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Un identificatore univoco del criterio posizione da modificare. Per modificare il criterio percorso globale, utilizzare un valore Global. Per un criterio creato nell'ambito del sito, tale valore avrà il formato site:<nome sito>, dove nome sito è il nome di un sito definito nella distribuzione di Microsoft Lync Server 2010, ad esempio site:Redmond. Per un criterio creato nell'ambito per utente, tale valore sarà semplicemente il nome del criterio, ad esempio Reno.

Instance

Facoltativo

LocationPolicy

Un riferimento all'oggetto criterio posizione. L'oggetto deve essere di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy, recuperabile chiamando Get-CsLocationPolicy. Recuperare l'oggetto, modificare le proprietà in memoria, quindi passare il riferimento oggetto come valore al parametro per aggiornare il criterio percorso.

ConferenceMode

Facoltativo

ConferenceModeEnum

Se viene specificato un valore per il parametro ConferenceUri, il parametro ConferenceMode determinerà se terze persone possono partecipare alla chiamata o solo ascoltare. I valori disponibili sono i seguenti:

- oneway: terze persone possono solo ascoltare la conversazione tra il chiamante e l'operatore del 112.

- twoway: terze persone possono ascoltare e partecipare alla chiamata tra il chiamante e l'operatore del 112.

ConferenceUri

Facoltativo

Stringa

L'URI (Uniform Resource Identifier) SIP, in questo caso il numero di telefono, di terze persone che parteciperanno alle chiamate di emergenza effettuate. Ad esempio, l'ufficio che si occupa della sicurezza aziendale potrebbe ricevere una chiamata quando viene effettuata una chiamata di emergenza e ascoltare o partecipare alla chiamata (in base al valore della proprietà ConferenceMode).

La stringa deve avere una lunghezza compresa tra 1 e 256 caratteri e deve iniziare con il prefisso sip:.

Description

Facoltativo

Stringa

Una descrizione dettagliata della posizione. Ad esempio, "Edificio 30, terzo piano, angolo nord-est".

EmergencyDialMask

Facoltativo

Stringa

Un numero composto che viene convertito nel valore della proprietà EmergencyDialString. Ad esempio, se il valore di EmergencyDialMask è "911" e il valore di EmergencyDialString è "112", quando un utente compone il 911, la chiamata verrà effettuata al 112. In questo modo si ha la garanzia di contattare comunque i servizi di emergenza, anche qualora un utente straniero componga un numero di emergenza alternativo specifico del proprio Paese anziché quello attivo in Italia. È possibile definire più maschere di composizione numeri di emergenza separando i diversi valori con punto e virgola, ad esempio -EmergencyDialMask "212;414".

IMPORTANTE: accertarsi che il valore specificato come maschera di composizione non corrisponda a un numero dell'intervallo di un orbit del parcheggio di chiamata. L'instradamento del parcheggio di chiamata avrà infatti la precedenza sulla conversione delle stringhe di composizione per le chiamate di emergenza. Per visualizzare gli intervalli degli orbit del parcheggio di chiamata esistenti, chiamare il cmdlet Get-CsCallParkOrbit.

La lunghezza massima della stringa è 100 caratteri. Ogni carattere deve essere costituito da una cifra compresa tra 0 e 9.

EmergencyDialString

Facoltativo

Stringa

Il numero che viene composto per chiamare i servizi di emergenza. In Italia il numero è "112".

La stringa deve essere costituita da cifre comprese tra 0 e 9 e da una lunghezza massima di 10 caratteri.

EnhancedEmergencyServicesEnabled

Facoltativo

Booleano

Consente di specificare se gli utenti associati al criterio sono abilitati per la funzionalità relativa alle chiamate di emergenza. Impostare il valore su True per abilitare il servizio; i client Lync Server recupereranno le informazioni sulla posizione specificate alla registrazione e includeranno tali informazioni quando viene effettuata una chiamata di emergenza.

LocationRequired

Facoltativo

LocationRequiredEnum

Se il client non è in grado di recuperare una posizione dal database di configurazione delle posizioni, all'utente potrà essere richiesta l'immissione manuale. I valori validi per questo parametro sono i seguenti:

- no: all'utente non verrà richiesto di immettere la posizione. Quando viene effettuata una chiamata senza informazioni sulla posizione, il provider dei servizi di emergenza risponderà alla chiamata e richiederà la posizione.

- yes: all'utente verrà richiesta l'immissione delle informazioni sulla posizione quando il client registra una nuova posizione. L'utente può ignorare il prompt e non immettere alcuna informazione. Se le informazioni vengono immesse, alla chiamata effettuata al 112 risponderà innanzitutto il provider dei servizi di emergenza per verificare la posizione prima dell'instradamento all'operatore del 112.

- disclaimer: questa opzione è analoga all'opzione - yes, con la differenza che se l'utente ignora la richiesta, viene visualizzato il testo della dichiarazione di non responsabilità in cui vengono comunicate le conseguenze derivanti dal rifiuto di immettere le informazioni sulla posizione. Per impostare il testo della dichiarazione di non responsabilità, chiamare il cmdlet Set-CsEnhancedEmergencyServiceDisclaimer.

Il valore viene ignorato se EnhancedEmergencyServicesEnabled è impostato su False (impostazione predefinita). Agli utenti non verrà richiesto di immettere le informazioni sulla posizione.

NotificationUri

Facoltativo

Stringa

Uno o più URI SIP a cui inviare una notifica quando viene effettuata una chiamata di emergenza. Ad esempio, l'ufficio che si occupa della sicurezza aziendale potrebbe ricevere una notifica tramite messaggio istantaneo ogni volta che viene effettuata una chiamata di emergenza. Se la posizione del chiamante è disponibile, verrà inclusa nella notifica.

È possibile specificare più URI SIP sotto forma di elenco delimitato da virgole, ad esempio -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Tenere presente che le liste di distribuzione e gli URI di gruppi non sono supportati.

La stringa deve avere una lunghezza compresa tra 1 e 256 caratteri e deve iniziare con il prefisso sip:.

PstnUsage

Facoltativo

Stringa

L'utilizzo della rete PSTN (Public Switched Telephone Network) in base al quale verrà determinata la route vocale di cui avvalersi per instradare le chiamate al 112 dai client con questo profilo. La route associata a questo utilizzo deve puntare a un SIP trunk dedicato alle chiamate di emergenza.

L'utilizzo deve già esistere nell'elenco globale degli utilizzi PSTN. Per recuperare tale elenco, chiamare il cmdlet Get-CsPstnUsage. Per creare un nuovo utilizzo, chiamare il cmdlet Set-CsPstnUsage.

UseLocationForE911Only

Facoltativo

Booleano

Le informazioni sulla posizione possono essere utilizzate dal client Microsoft Lync 2010 per diversi motivi, ad esempio per la notifica della posizione corrente ai membri del team. Impostare questo valore su True per assicurarsi che le informazioni sulla posizione siano disponibili per l'utilizzo con una chiamata di emergenza.

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.WritableConfig.Policy.Location.LocationPolicy. Accetta l'input da pipeline di oggetti criterio percorso.

Tipi restituiti

Questo cmdlet non restituisce un valore o un oggetto. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Esempio

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

Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True

In questo comando viene utilizzato il cmdlet Set-CsLocationPolicy per modificare il criterio percorso con valore Identity site:Redmond. In altri termini, viene modificato il criterio posizione applicato al sito Redmond. In tal caso, il comando consente di impostare su True il valore della proprietà EnhancedEmergencyServicesEnabled, che abiliterà la funzionalità E9-1-1 per tutti gli utenti connessi al sito Redmond (in questo caso).

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

Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway

Nell'esempio 2 vengono modificati tutti i criteri percorso in uso nell'organizzazione per i quali è stato definito un URI conferenza in modo che la modalità conferenza sia impostata su twoway. Per eseguire questa attività, nel comando viene innanzitutto utilizzato Get-CsLocationPolicy per restituire una raccolta di tutti i criteri percorso attualmente definiti. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object per circoscrivere la raccolta ai criteri percorso la cui proprietà ConferenceUri non è vuota (diversa da Null). In questo modo si ottiene una raccolta di criteri posizione che dispongono di valori ConferenceUri. La raccolta viene quindi inviata tramite pipe a Set-CsLocationPolicy, che modifica il valore della proprietà ConferenceMode per ogni criterio della raccolta impostando tale valore su twoway.