Set-CsLisSwitch
Ultima modifica dell'argomento: 2012-04-23
Crea uno switch di Location Information Server (LIS), crea un'associazione tra un connettore e una posizione (creando una nuova posizione se tale posizione non esiste) o modifica un connettore esistente e la relativa posizione associata. L'associazione tra un commutatore e una posizione viene utilizzata in un'implementazione relativa alle chiamate di emergenza di VoIP aziendale per notificare la posizione del chiamante a un operatore di servizi di emergenza.
Sintassi
Set-CsLisSwitch -ChassisID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSwitch -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
La funzionalità per le chiamate di emergenza consente all'operatore di identificare la posizione del chiamante senza doverla richiedere a quest'ultimo. Nel caso in cui la chiamata sia effettuata da una connessione VoIP (Voice over Internet Protocol), queste informazioni devono essere estrapolate in base a diversi fattori di connessione. L'amministratore VoIP deve configurare una mappa di posizioni (detta mappa reticolare) che permetta di determinare la posizione di un chiamante. Questo cmdlet consente all'amministratore di mappare le posizioni fisiche al connettore di rete tramite cui il cliente viene connesso.
Il parametro ChassisID è l'unico parametro richiesto per questo cmdlet. Se si immette un valore ChassisID già esistente, questo cmdlet aggiorna la posizione di tale connettore in base ai parametri di posizione forniti. Se ChassisID non esiste, verrà creata una nuova posizione commutatore.
Se nel database delle posizioni non esiste una posizione con un indirizzo che corrisponde esattamente ai parametri immessi qui (inclusi i valori NULL), verrà creato un nuovo indirizzo in base ai parametri immessi con questo cmdlet. Per recuperare un elenco di posizioni, è possibile chiamare il cmdlet Get-CsLisLocation. Il cmdlet Set-CsLisSwitch non richiede parametri di posizione. È possibile creare una voce commutatore senza associarla a una posizione. È inoltre possibile creare una posizione non valida con questo cmdlet. Una posizione valida è costituita, come minimo, dai parametri Location, HouseNumber, StreetName, City, State e Country. Se non si forniscono tutti questi parametri, è possibile che le chiamate ricevute dal commutatore a cui si fa riferimento non contengano le informazioni richieste dall'operatore di emergenza (a seconda del fatto che siano disponibili o meno impostazioni valide per una subnet o un punto di accesso wireless utilizzabili in sostituzione delle impostazioni del commutatore). È consigliabile essere più specifici possibile con i parametri della posizione e completarne il maggior numero possibile.
È anche possibile creare le voci commutatore chiamando il cmdlet Set-CsLisPort. Se si chiama Set-CsLisPort con un valore ChassisID che non presenta una voce commutatore esistente, tale commutatore verrà creato.
È importante notare che queste modifiche hanno effetto solo se la proprietà MACResolverUrl è stata configurata tramite il cmdlet New-CsWebServiceConfiguration o Set-CsWebServiceConfiguration. La proprietà MACResolverUrl specifica l'URL di un servizio Web in grado di determinare da un indirizzo IP l'indirizzo MAC (Media Access Control) della scheda di rete associata all'indirizzo IP.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsLisSwitch i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "Set-CsLisSwitch"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
ChassisID |
Obbligatorio |
Stringa |
Indirizzo MAC (Media Access Control) del commutatore di rete. Questo valore deve essere in formato nn-nn-nn-nn-nn-nn, ad esempio 12-34-56-78-90-ab, o nel formato di un indirizzo IP. Se non esiste una voce con il valore ChassisID specificato, verrà creata una nuova posizione commutatore. Se non esiste una voce con il parametro ChassisID specificato, tale voce verrà sostituita. |
City |
Obbligatorio |
Stringa |
La città della posizione. Lunghezza massima: 64 caratteri. |
CompanyName |
Obbligatorio |
Stringa |
Il nome della società in questa posizione. Lunghezza massima: 60 caratteri |
Country |
Obbligatorio |
Stringa |
Il paese o l'area geografica relativa alla posizione. Lunghezza massima: 2 caratteri |
Description |
Facoltativo |
Stringa |
Una descrizione dettagliata di questa posizione commutatore di rete. |
HouseNumber |
Obbligatorio |
Stringa |
Il numero civico della posizione. Nel caso di una società indica il numero della strada in cui ha sede la società. Lunghezza massima: 10 caratteri |
HouseNumberSuffix |
Obbligatorio |
Stringa |
Informazioni aggiuntive sul numero civico, come 1/2 o A. Ad esempio: 1234 1/2 Oak Street o 1234 A Elm Street. Nota: per indicare un numero di appartamento o di un ufficio, è necessario utilizzare il parametro Location. Ad esempio: -Location "Suite 100/Office 150". Lunghezza massima: 5 caratteri |
Location |
Obbligatorio |
Stringa |
Il nome della posizione. Generalmente questo valore è il nome di una posizione più specifica rispetto all'indirizzo civico, quale un numero di ufficio, ma può essere qualsiasi valore stringa. Lunghezza massima: 20 caratteri |
PostalCode |
Obbligatorio |
Stringa |
Il codice postale associato a questa posizione. Lunghezza massima: 10 caratteri |
PostDirectional |
Obbligatorio |
Stringa |
La designazione direzionale di una via. Esempio: NE o NW per Main Street NE o 7th Avenue NW. Lunghezza massima: 2 caratteri |
PreDirectional |
Obbligatorio |
Stringa |
La designazione direzionale per un nome di una via che precede il nome della via. Esempio: NE o NW per NE Main Street o NW 7th Avenue. Lunghezza massima: 2 caratteri |
State |
Obbligatorio |
Stringa |
Lo stato o la provincia associato a questa posizione. Lunghezza massima: 2 caratteri |
StreetName |
Obbligatorio |
Stringa |
Il nome della via per questa posizione. Lunghezza massima: 60 caratteri |
StreetSuffix |
Obbligatorio |
Stringa |
Il tipo di via indicato nel nome, ad esempio Street, Avenue o Court. Lunghezza massima: 10 caratteri |
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
Accetta l'input da pipeline di oggetti commutatore LIS.
Tipi restituiti
Questo cmdlet consente di creare o modificare un oggetto di tipo System.Management.Automation.PSCustomObject.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99
Nell'esempio 1 viene creata o aggiornata una voce posizione commutatore LIS. Il comando nell'esempio include solo un parametro (obbligatorio): ChassisID. Il valore di ChassisID è l'indirizzo MAC del commutatore, in questo caso 99-99-99-99-99-99.
Si noti che in questo esempio non vengono incluse informazioni sull'indirizzo. È possibile creare una voce commutatore sul Location Information Server senza associarla a un indirizzo. Tuttavia, le chiamate di emergenza instradate tramite questo commutatore potrebbero (a seconda della subnet o delle posizioni di porta definite) non contenere informazioni sufficiente perché l'operatore di emergenza identifichi una posizione.
IMPORTANTE: Se una posizione di un commutatore LIS con questo parametro ChassisID esiste già, verrà sostituito dai valori in questo comando. Questo significa che se questo commutatore fosse associato a un indirizzo (una posizione fisica), tale associazione non esisterebbe più perché non è stata inclusa nel comando alcuna informazioni sulla posizione. La posizione continuerà a esistere nel database delle posizioni ma non verrà associato a questo commutatore.
-------------------------- Esempio 2 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
Nell'esempio 2 viene aggiornato il commutatore creato nell'esempio 1 aggiungendo informazioni sull'indirizzo (in realtà verrà eliminata la voce esistente e sostituita con questa nuova voce). Se l'indirizzo non esiste nel database delle posizioni, questo cmdlet creerà tale posizione.
Vedere anche
Ulteriori risorse
Remove-CsLisSwitch
Get-CsLisSwitch
Get-CsLisLocation
Set-CsLisPort
Get-CsLisPort