Set-CsLisSubnet
Ultima modifica dell'argomento: 2012-03-27
Crea una subnet LIS (Location Information Server), crea un'associazione tra una subnet e una posizione (creandone una nuova se la posizione non esiste) oppure modifica una subnet esistente e la posizione a essa associata. L'associazione tra una subnet e una posizione viene utilizzata in un'implementazione VoIP aziendale per chiamate di emergenza per notificare la posizione del chiamante a un operatore di servizi di emergenza.
Sintassi
Set-CsLisSubnet -Subnet <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-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -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 a un operatore di servizi di emergenza di identificare la posizione del chiamante senza doverla richiedere a quest'ultimo. Nel caso in cui la chiamata venga effettuata tramite connessione VoIP (Voice over Internet Protocol), questa informazione deve essere estratta 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. Il cmdlet consente all'amministratore di eseguire il mapping delle posizioni fisiche alla subnet tramite cui il client è connesso.
Il parametro Subnet è l'unico parametro obbligatorio per questo cmdlet. Se si immette un valore Subnet che esiste già, con il cmdlet verrà aggiornata la posizione per tale subnet in base ai parametri della posizione forniti. Se non esiste, verrà creato un nuovo percorso per la subnet.
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 delle posizioni, è possibile chiamare il cmdlet Get-CsLisLocation. Il cmdlet Set-CsLisSubnet non richiede parametri relativi alla posizione. È possibile creare una voce di subnet senza associarla a una posizione. È inoltre possibile creare una posizione non valida con questo cmdlet. Una posizione valida è costituita almeno dai parametri Location, HouseNumber, StreetName, City, State e Country. Se tali parametri non vengono forniti, le chiamate che provengono dalla subnet specificata possono non contenere le informazioni necessarie all'operatore del servizio di emergenza (a seconda che siano disponibili impostazioni valide per un commutatore, una porta o un punto di accesso wireless che possono essere utilizzate al posto delle impostazioni della subnet). È consigliabile essere più specifici possibile con i parametri della posizione e completarne il maggior numero possibile.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsLisSubnet i membri dei seguenti gruppi: 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 "Set-CsLisSubnet"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Subnet |
Obbligatorio |
Stringa |
L'indirizzo IP della subnet. Il valore dovrebbe essere immesso come un indirizzo IPv4 (cifre separate da punti come 192.0.2.0). |
City |
Facoltativo |
Stringa |
La città della posizione. Lunghezza massima: 64 caratteri. |
CompanyName |
Facoltativo |
Stringa |
Il nome della società in questa posizione. Lunghezza massima: 60 caratteri |
Country |
Facoltativo |
Stringa |
Il Paese e la regione relativi alla posizione. Lunghezza massima: 2 caratteri |
Description |
Facoltativo |
Stringa |
Una descrizione dettagliata della posizione della subnet. |
HouseNumber |
Facoltativo |
Stringa |
Il numero civico della posizione. Nel caso di una società, è il numero della via in cui questa ha sede. Lunghezza massima: 10 caratteri |
HouseNumberSuffix |
Facoltativo |
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 |
Facoltativo |
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 |
Facoltativo |
Stringa |
Il codice postale associato a questa posizione. Lunghezza massima: 10 caratteri |
PostDirectional |
Facoltativo |
Stringa |
La designazione direzionale di una via. Esempio: NE o NW per Main Street NE o 7th Avenue NW. Lunghezza massima: 2 caratteri |
PreDirectional |
Facoltativo |
Stringa |
La designazione direzionale per un nome di una via che precede il nome della via. Ad esempio, NE o NW per NE Main Street o NW 7th Avenue. Lunghezza massima: 2 caratteri |
State |
Facoltativo |
Stringa |
Lo stato o la provincia associato a questa posizione. Lunghezza massima: 2 caratteri |
StreetName |
Facoltativo |
Stringa |
Il nome della via per questa posizione. Lunghezza massima: 60 caratteri |
StreetSuffix |
Facoltativo |
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 subnet LIS.
Tipi restituiti
Questo cmdlet consente di creare o modificare un oggetto di tipo System.Management.Automation.PSCustomObject.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsLisSubnet -Subnet 192.10.10.0
Nell'esempio 1 viene creata o aggiornata una voce di posizione della subnet LIS. Il comando nell'esempio include solo un parametro (obbligatorio): Subnet. Il valore del parametro Subnet riportato nell'esempio è un indirizzo IPv4, 192.10.10.0.
Si noti che in questo esempio non sono incluse informazioni sull'indirizzo. È possibile creare una voce di subnet in Location Information Server senza associarla a un indirizzo. Tuttavia, le chiamate di emergenza instradate tramite questa subnet non possono (in base alle posizioni di porta o commutatore che sono state definite) contenere informazioni sufficienti all'operatore del servizio di emergenza per identificare una posizione.
IMPORTANTE: Se esiste già una posizione subnet LIS con questo valore Subnet, questa verrà sostituita dai valori utilizzati nel comando. Ciò significa che se la subnet era associata a un indirizzo (una posizione fisica), tale associazione non esiste più poiché nel comando non sono incluse informazioni sull'indirizzo. La posizione esisterà ancora nel database delle posizioni, ma non sarà associata a questa subnet.