Condividi tramite

  • Articolo

Remove-CsLocationPolicy

 

Ultima modifica dell'argomento: 2012-03-27

Rimuove i criteri percorso. I criteri percorso vengono utilizzati con il servizio Enhanced 9-1-1 per consentire a chi risponde alle chiamate di emergenza di determinare la località geografica del chiamante in base al numero del telefono o del dispositivo utilizzato per effettuare la chiamata.

Sintassi

Remove-CsLocationPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I criteri percorso vengono usati per applicare impostazioni che mettono in relazione la funzionalità E9-1-1. I criteri percorso stabiliscono se un utente è abilitato per la funzionalità E9-1-1 e, in caso affermativo, quale comportamento tenere per una chiamata di emergenza. Ad esempio, è possibile usare i criteri percorso per definire quale numero costituisce una chiamata di emergenza (911 negli Stati Uniti), se la sicurezza aziendale deve essere automaticamente informata, come deve essere instradata la chiamata e così via. Questo cmdlet consente di rimuovere i criteri percorso esistenti.

Oltre che per rimuovere criteri percorso per sito e per utente, questo cmdlet può essere utilizzato per rimuovere anche criteri percorso globali. In questo caso, però, i criteri non vengono effettivamente rimossi; in realtà, il risultato è la reimpostazione dei valori predefiniti per le impostazioni dei criteri.

Se questo cmdlet viene eseguito nei confronti di criteri percorso per utente assegnati ad un utente, verrà richiesto di confermarne l'eliminazione.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsLocationPolicy 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 "Remove-CsLocationPolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

L'identificatore univoco dei criteri percorso che si desidera rimuovere. Per rimuovere i criteri percorso globali (ripristinando così i valori predefiniti per i criteri), utilizzare il valore Global. Per i criteri creati nell'ambito del sito, questo valore ha il formato site:<nome sito>, dove "nome sito" è il nome del sito definito nella distribuzione di Microsoft Lync Server 2010 (ad esempio, site:Redmond). Per i criteri creati nell'ambito del singolo utente, questo valore è il nome del criterio (ad esempio, Bldg30Floor3Sector1).

Force

Facoltativo

Parametro opzionale

Specificando questo parametro si eviteranno tutti i messaggi di conferma e l'eliminazione avverrà senza alcuna notifica. Ad esempio, se criteri per utente sono assegnati ad uno o più utenti e questo parametro non viene inserito nel comando, verrà visualizzato un messaggio di conferma prima dell'eliminazione.

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 input tramite pipeline da oggetti criterio località.

Tipi restituiti

Questo cmdlet non restituisce alcun oggetto o valore. Il cmdlet rimuove invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Esempio

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

Remove-CsLocationPolicy -Identity Reno

Il comando riportato nell'Esempio 1 utilizza il cmdlet Remove-CsLocationPolicy per eliminare i criteri percorso con Identity Reno. Quando vengono rimossi criteri per utente, gli utenti o i gruppi ai quali erano stati assegnati quei criteri utilizzeranno automaticamente i criteri definiti per il loro sito. Se non sono stati configurati criteri per il sito, questi utenti o gruppi utilizzeranno i criteri percorso globali.

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

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

L'Esempio 2 elimina tutti i criteri percorso dove il valore della proprietà EnhancedEmergencyServicesEnabled è False. In altre parole eliminerà tutti criteri che non abilitano E9-1-1. Per ottenere questo risultato il comando prima utilizza Get-CsLocationPolicy per recuperare i criteri percorso attualmente in uso nell'organizzazione. Questa raccolta vene quindi inviata tramite pipe al cmdlet Where-Object che applica un filtro per ottenere solo i dati relativi a quei criteri in cui la proprietà EnhancedEmergencyServicesEnabled è uguale a (-eq) False ($False). Infine, questa raccolta filtrata viene inviata al cmdlet Remove-CsLocationPolicy che elimina ogni criterio della raccolta.