Remove-CsLisPort
Ultima modifica dell'argomento: 2012-03-27
Rimuove un'associazione tra una porta Location Information Server (LIS) e una posizione. Tale associazione viene utilizzata in un'implementazione VoIP aziendale per chiamate di emergenza per notificare a un operatore dei servizi di emergenza la posizione del chiamante.
Sintassi
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-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. Questo cmdlet rimuove un'associazione tra una posizione fisica e una porta attraverso la quale verranno instradate le chiamate rimuovendo la porta dal database di configurazione delle posizioni.
La rimozione di una posizione di porta non comporta la rimozione della posizione effettiva della porta. Viene rimossa solo la porta. Per rimuovere la posizione, chiamare il cmdlet Remove-CsLisLocation. La rimozione della porta inoltre non comporterà la rimozione del commutatore con il valore ChassisID specificato. Per rimuovere il commutatore, sarà necessario chiamare il cmdlet Remove-CsLisSwitch.
Se si tenta di rimuovere una porta che non esiste, non verrà effettuata alcuna azione e non si riceverà alcun errore o messaggio di avviso.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsLisPort 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 "Remove-CsLisPort"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
ChassisID |
Obbligatorio |
Stringa |
Indirizzo MAC (Media Access Control) del commutatore della porta. Questo valore presenta il formato nn-nn-nn-nn-nn-nn, ad esempio, 12-34-56-78-90-ab. |
PortID |
Obbligatorio |
Stringa |
ID della porta da rimuovere. |
PortIDSubType |
Obbligatorio |
PortIDSubType |
Sottotipo della porta da rimuovere. Questo valore può essere immesso come valore numero o stringa ma deve essere un sottotipo valido. I sottotipi validi sono: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
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 porta LIS.
Tipi restituiti
Questo cmdlet non restituisce un valore. Rimuovere un oggetto di tipo System.Management.Automation.PSCustomObject.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
Nell'esempio 1 viene rimossa la porta LIS con indirizzo MAC (ChassisID) 99-99-99-99-99-99, PortID 4200 e PortIDSubType 1. Si noti che un valore PortIDSubType pari a 1 si converte in un valore di InterfaceAlias. Questo parametro e valore può anche essere immesso come segue: -PortIDSubType InterfaceAlias
Se questa porta è stata associata a una posizione, tale posizione non verrà rimossa. Verrà rimossa solo la porta dal mapping della posizione.
-------------------------- Esempio 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
In questo esempio vengono rimosse tutte le posizioni delle porte che non hanno un numero civico. L'esempio inizia con una chiamata al cmdlet Get-CsLisPort, che restituisce una raccolta di tutte le porte LIS. La raccolta viene inviata tramite pipe al cmdlet Where-Object, che trova tutti gli elementi della raccolta con proprietà HouseNumber vuota, ovvero una proprietà HouseNumber uguale a (-eq) una stringa vuota (""). Questa raccolta di posizioni di porte con proprietà HouseNumber vuota viene infine inviata tramite pipe al cmdlet Remove-CsLisPort, che rimuove ogni elemento della raccolta.
Analogamente all'esempio 1, non viene rimossa alcuna posizione dal database di configurazione delle posizioni. Vengono rimosse solo le porte che fanno riferimento a tali posizioni. In questo caso, ciò significa che saranno presenti posizioni non valide (non valide poiché HouseNumber è una proprietà richiesta per una posizione) nel database delle posizioni che devono essere rimosse. È possibile rimuovere le posizioni chiamando il cmdlet Remove-CsLisLocation.