Condividi tramite

  • Articolo

New-CsLocationPolicy

 

Ultima modifica dell'argomento: 2012-03-26

Crea un nuovo criterio percoso da utilizzare con l'identificazione della posizione per il servizio chiamate di emergenza e la posizione generale del client. Il servizio per le chiamate di emergenza consente agli operatori che rispondono alle chiamate dei servizi di emergenza di determinare la posizione geografica del chiamante.

Sintassi

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

Descrizione dettagliata

Il criterio percorso è utilizzato per applicare agli utenti o ai contatti le impostazioni relative alla funzionalità delle chiamate di emergenza e alla posizione. Il criterio percorso determina 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 i numeri che rappresentano una chiamata di emergenza (112 in Italia), per definire se inviare o meno una notifica all'ufficio di sicurezza aziendale, la modalità di instradamento della chiamata e così via. Questo cmdlet consente di creare un nuovo criterio percorso nell'ambito del sito per utente. Nell'ambito globale esiste già un criterio.

IMPORTANTE: il criterio percorso si comporta diversamente dagli altri criteri di Lync Server 2010 in termini di ordine dell'ambito. Per tutti gli altri criteri, i criteri definiti nell'ambito per utente vengono applicati a qualsiasi utente a cui sono stati concessi. Se all'utente non sono stati concessi criteri per utente, vengono applicati i criteri a livello di sito. Se non sono presenti criteri a livello di sito, vengono applicati i criteri globaliè presente. I criteri percorso vengono applicati nello stesso modo, ma con una eccezione: un criterio percorso per utente può essere assegnato anche a un sito di rete. Una rete è costituita da un gruppo di subnet. Se l'utente effettua la chiamata di emergenza all'interno di una posizione mappata a un sito di rete nell'organizzazione), viene utilizzato il criterio a livello di utente assegnato a quel sito di rete. Questa funzionalità sostituisce i criteri per utente concessi a a tale utente. Se l'utente chiama da una posizione sconosciuta o non mappata nell'organizzazione, viene applicato l'ambito dei criteri standard.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsLocationPolicy in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per il criterio percorso. Questo cmdlet consente di creare nuovi criteri nel sito o nell'ambito per utente. Un criterio globale è presente per impostazione predefinita e non può essere rimosso. Per un criterio creato nell'ambito del sito, questo valore deve essere nella forma site:<nome sito>, dove nome sito è il nome di un sito definito nella distribuzione di Microsoft Lync Server 2010. Ad esempio: site:Redmond. A un criterio creato con ambito per utente può essere assegnato qualsiasi valore stringa, ad esempio Reno.

ConferenceMode

Facoltativo

ConferenceModeEnum

Se viene specificato un valore per il parametro ConferenceUri, il parametro ConferenceMode determina se le terze parti possono partecipare alla chiamata o solo ascoltare. I valori disponibili sono:

- oneway: le terze parti 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, delle terze parti che parteciperanno in conferenza 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: "Reno corporate users".

EmergencyDialMask

Facoltativo

Stringa

Un numero composto che viene convertito nel valore della proprietà EmergencyDialString. Per esempio, se il valore di EmergencyDialMask è "113" mentre il valore di EmergencyDialString è "112", se un utente compone 113 la chiamata viene comunque effettuata al 112. In questo modo viene consentita la composizione di numeri di emergenza alternativi, consentendo nello stesso tempo alle chiamate di raggiungere i servizi di emergenza (ad esempio, se una persona proveniente da un paese diverso con un diverso numero di emergenza tenta di comporre il numero del proprio paese anziché il numero del paese in cui si trova attualmente). È possibile definire più maschere di composizione del numero di emergenza separando i valori con un punto e virgola. Esempio: -EmergencyDialMask "212;414".

IMPORTANTE: verificare che il valore specificato per la maschera di composizione non corrisponda a un numero in un intervallo dell'orbit del parcheggio di chiamata. Il routing del parcheggio di chiamata avrà la precedenza sulla conversione della stringa di composizione del numero di emergenza. Per vedere gli intervalli dell'orbit del parcheggio di chiamata, 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 con una lunghezza massima di 10 cifre.

EnhancedEmergencyServicesEnabled

Obbligatorio

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 2010 recupereranno le informazioni sulla posizione specificate alla registrazione e includeranno tali informazioni quando viene effettuata una chiamata di emergenza.

Valore predefinito: False

LocationRequired

Facoltativo

LocationRequiredEnum

Se il client non è in grado di recuperare una posizione dal database di configurazione delle posizioni, all'utente può essere richiesta l'immissione manuale di una posizione. 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, il provider dei servizi di emergenza risponderà alla chiamata effettuata al 112 per controllare 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. La posizione del chiamante, se disponibile, viene inclusa nella notifica.

Per includere più URI SIP, utilizzare un elenco separato da virgole. Esempio: -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Tenere presente che le liste di distribuzione e gli URI di gruppo 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 PSTN (Public Switched Telephone Network) che verrà impiegato per determinare la route vocale utilizzata per instradare le chiamate di emergenza dai client che utilizzano questo profilo. La route associata a questo utilizzo deve puntare a un SIP trunk dedicato alle chiamate di emergenza.

L'utilizzo deve già essere presente nell'elenco globale di utilizzi PSTN. Chiamare il cmdlet Get-CsPstnUsage per recuperare un elenco di utilizzi. 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 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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Esempio

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

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

Con l'esempio 1 viene utilizzato New-CsLocationPolicy per creare un nuovo criterio percorso per il sito Redmond che abiliti tutti gli utenti di quel sito alle chiamate di emergenza. Per creare questo criterio viene chiamato New-CsLocationPolicy con due parametri: uno per impostare l'identità, che in questo caso è la stringa site: seguita dal nome del sito a cui si applica questo criterio; l'altro per impostare il valore della proprietà EnhancedEmergencyServicesEnabled su True.

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

New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911

Con questo esempio viene creato un criterio percorso per utente. I criteri per utente devono essere concessi in modo specifico a singoli utenti o gruppi. Questo criterio ha l'identità Reno. È stata aggiunta una descrizione più dettagliata del criterio utilizzando il parametro Description. Il successivo parametro da fornire è EnhancedEmergencyServicesEnabled, che viene impostato su True per attivare la funzionalità E9-1-1 per tutti gli utenti a cui viene concesso questo criterio. Il parametro successivo è PstnUsage, in questo caso con un valore Emergency. Questo valore deve corrispondere a un valore nell'elenco di utilizzi PSTN. Questo elenco può essere recuperato chiamando Get-CsPstnUsage. L'utilizzo dovrebbe essere associato a una route vocale che sarà utilizzata per le chiamate di emergenza. È possibile recuperare le route vocali chiamando il cmdlet Get-CsVoiceRoute. Il parametro finale utilizzato in questo esempio è EmergencyDialString, che specifica il numero composto per effettuare una chiamata di emergenza.