Test-CsLocationPolicy
Ultima modifica dell'argomento: 2012-03-26
Consente di eseguire un test per determinare i criteri percorso che verranno utilizzati basati sui criteri specificati nei valori del parametro. I criteri percorso contengono le impostazioni che stabiliscono se e come verrà applicata la funzionalità Enhanced 9-1-1 (E9-1-1), che consente achi risponde alle chiamate di emergenza al 911 di determinare la posizione geografica del chiamante.
Sintassi
Test-CsLocationPolicy -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]
Test-CsLocationPolicy [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>]
Descrizione dettagliata
I criteri percorso vengono utilizzati per applicare impostazioni che mettono in relazione la funzionalità E9-1-1 con la posizione del client. 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 utilizzare i criteri percorso per definire quale numero costituisce una chiamata di emergenza (112 in Italia), se inviare o meno una notifica all'ufficio di sicurezza aziendale, la modalità di instradamento della chiamata e così via. Questo cmdlet restituisce le informazioni sui criteri percorso che verranno utilizzati quando la chiamata viene effettuata da un particolare client su uno specifico pool, subnet, switch o punto di accesso wireless.
Se non viene specificato un utente quando si utilizza questo cmdlet, verrà testato l'utente attualmente configurato. Per trovare l'utente attualmente configurato, utilizzare il cmdlet Get-CsHealthMonitoringConfiguration. Per impostare l'utente configurato, utilizzare il cmdlet Set-CsHealthMonitoringConfiguration.
Se vengono trovati i criteri percorso per l'utente o per la subnet, il test termina correttamente. Per impostazione predefinita, le informazioni ottenute includono il nome dei criteri percorso (se sono assegnati criteri per utente) e l'indicazione se l'utente o la subnet è abilitato per la funzionalità E9-1-1. Includere il parametro Verbose di Windows PowerShell per ottenere informazioni aggiuntive sul test.
È possibile testare i criteri percorso su utenti o subnet di rete. Se si esegue il test su una subnet (specificando un valore per il parametro Subnet), il cmdlet tenterà di risolvere i criteri percorso per quella subnet. Se alla subnet non sono assegnati criteri percorso, verranno recuperati i criteri percorso per l'utente configurato. Se i criteri percorso vengono recuperati correttamente, l'output includerà un valore LocationPolicyTagID che inizia con subnet-tagid. Se non vengono trovati criteri percorso per la subnet, LocationPolicyTagID inizierà con user-tagid.
Utenti autorizzati a eseguire questo cmdlet: per impostazione predefinita, il cmdlet Test-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 "Test-CsLocationPolicy"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
TargetFqdn |
Obbligatorio |
Stringa |
Il nome di dominio completo (FQDN) del pool su cui è in esecuzione il servizio di registrazione. Se non viene specificato un utente verrà assunto l'utente preconfigurato o corrente. |
OutVerboseVariable |
Facoltativo |
Stringa |
Quando presente, l'output dettagliato relativo all'esecuzione del cmdlet verrà archiviato nella variabile specificata. Per archiviare, ad esempio, l'output in una variabile denominata $TestOutput, utilizzare la sintassi seguente: -OutVerboseVariable TestOutput Non anteporre un carattere $ quando si specifica il nome della variabile. |
RegistrarPort |
Facoltativo |
Numero intero |
Il numero di porta del servizio di registrazione. |
Subnet |
Facoltativo |
Stringa |
L'ID (l'indirizzo IP) della subnet di rete per la quale si vogliono testare i criteri percorso. |
UserCredential |
Facoltativo |
Oggetto PSCredential |
Un oggetto che contiene l'ID utente e la password dell'account utente del quale si vogliono testare i criteri percorso. Un oggetto Credential può essere recuperato utilizzando il cmdlet Get-Credential di Windows PowerShell, fornendo le informazioni necessarie e salvando l'output in una variabile. |
UserSipAddress |
Facoltativo |
Indirizzo SIP |
L'indirizzo SIP dell'utente del quale si vogliono testare i criteri percorso. Deve essere nel formato sip:<ID utente>, ad esempio, sip:davidegarghentini@litwareinc.com. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche. |
Tipi di input
Nessuno.
Tipi restituiti
Test-CsLocationPolicy restituisce un'istanza dell'oggetto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com
Questo esempio determina i criteri percorso dell'utente corrente (o correntemente configurato). TargetFqdn è obbligatorio.
-------------------------- Esempio 2 --------------------------
$cred = Get-Credential "litwareinc\kenmyer"
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred -UserSipAddress "sip:kenmyer@litwareinc.com"
Nella prima riga dell'Esempio 2 viene utilizzato il cmdlet Get-Credential di Windows PowerShell. Questo cmdlet recupererà le credenziali dell'utente e le restituisce come un oggetto protetto. Il solo parametro fornito a questo cmdlet è l'ID utente. Quando si utilizza questo cmdlet, si aprirà una finestra di dialogo in cui l'ID utente è già inserito e dove è disponibile una casella di testo in cui digitare la password dell'utente. Queste credenziali utente vengono salvate nella variabile $cred.
Nella riga 2 viene utilizzato il cmdlet Test-CsLocationPolicy. Proprio come nell'Esempio 1, viene fornita la destinazione FQDN. Tuttavia, in questo esempio, invece di usare l'utente preconfigurato, il test verrà eseguito per l'utente con indirizzo SIP davidegarghentini@litwareinc.com. Viene fornito il valore (con prefisso sip: prefix) per il parametro UserSipAddress e le credenziali per quell'utente (memorizzate nella variabile $cred) per il parametro UserCredential.
-------------------------- Esempio 3 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com"
Questo esempio è simile all'Esempio 2, ma non prevede che vengano fornite le credenziali utente. Quando si utilizza il cmdlet Test-CsLocationPolicy senza specificare le credenziali utente, per autenticare e rilevare i criteri percorso dell'utente viene utilizzato il certificato server presente sul computer in cui viene eseguito il cmdlet. Se il computer non dispone di un certificato server, è necessario fornire le credenziali come mostrato nell'Esempio 2. Per verificare se sul computer è presente un certificato server, utilizzare il cmdlet Get-CsCertificate.
-------------------------- Esempio 4 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -Subnet 172.15.11.0
Questo esempio determina i criteri percorso per la subnet con subnet ID 172.15.11.0. Se alla subnet non sono associati criteri percorso, verranno recuperati i criteri percorso dell'utente configurato.
Nota: per definire i criteri percorso su una subnet, impostare il parametro LocationPolicy del cmdlet Set-CsNetworkSite sull'ID dei criteri percorso e il parametro NetworkSiteId del cmdlet Set-CsNetworkSubnet sull'ID di quel sito. Ad esempio:
Set-CsNetworkSite Portland –LocationPolicy Reno
Set-CsNetworkSubnet 175.15.11.0 –NetworkSiteID Portland