Condividi tramite

  • Articolo

Get-CsLocationPolicy

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulla modalità di configurazione del servizio Informazioni percorso per le chiamate di emergenza o sull'eventualità che sia stato configurato. Il servizio per le chiamate di emergenza consente agli operatori che rispondono alle chiamate di emergenza di determinare la posizione geografica del chiamante.

Sintassi

Get-CsLocationPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsLocationPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Il criterio percorso viene utilizzato per applicare le impostazioni relative alla funzionalità del servizio chiamate di emergenza. 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 (113 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 recupera uno o più criteri di identificazione della posizione.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco del criterio di identificazione della posizione che si desidera recuperare. Per recuperare un criterio percorso globale, utilizzare il valore Global. Per un criterio creato nell'ambito del sito, il 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, il valore corrisponderà semplicemente al nome del criterio, ad esempio Reno.

Filter

Facoltativo

Stringa

Una stringa contenente caratteri jolly che recupererà criteri di identificazione della posizione in base alla corrispondenza del valore Identity del criterio alla stringa jolly.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni relative al criterio percorso dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsLocationPolicy restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Esempio

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

Get-CsLocationPolicy

Nell'esempio 1 viene restituita una raccolta di tutti i criteri di identificazione della posizione attualmente in uso nell'organizzazione, semplicemente chiamando Get-CsLocationPolicy senza specificare alcun parametro.

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

Get-CsLocationPolicy -Identity Reno

Il comando mostrato nell'esempio 2 restituisce solo quei criteri di identificazione della posizione il cui valore Identity è uguale a Reno. Poiché le identità devono essere univoche, il comando restituirà al massimo un criterio di identificazione della posizione.

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

Get-CsLocationPolicy -Filter tag:*

Il precedente comando utilizza il parametro Filter per restituire tutti i criteri di identificazione della posizione che sono stati configurati con ambito per utente. I criteri configurati creati con ambito per utente possono essere assegnati direttamente a utenti e siti della rete. La stringa con carattere jolly tag:* indica a Get-CsLocationPolicy di limitare i dati restituiti ai criteri percorso con valore Identity che inizia con il valore stringa tag:. Sebbene non occorra specificare il prefisso tag: quando si recupera un singolo criterio, è possibile utilizzare tale prefisso per applicare un filtro a tutti i criteri per utente.

-------------------------- Esempio 4 --------------------------

Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $False}

Nell'esempio 4 viene restituita una raccolta di tutti i criteri percorso con servizi di chiamate di emergenza disabilitati. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsLocationPolicy per restituire una raccolta di tutti i criteri percorso attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. A sua volta, Where-Object applica un filtro per limitare i dati restituiti ai criteri con proprietà EnhancedEmergencyServicesEnabled uguale a (-eq) False ($False).