Remove-CsLisSwitch
Ultima modifica dell'argomento: 2012-03-27
Rimuove un commutatore di rete del server Location Information Server (LIS).
Sintassi
Remove-CsLisSwitch -ChassisID <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 rimuove un commutatore dal database di configurazione delle posizioni. La rimozione di un commutatore non comporta la rimozione della posizione effettiva. Viene rimosso solo il commutatore. Per rimuovere la posizione, chiamare il cmdlet Remove-CsLisLocation.
Non è possibile rimuovere un commutatore se il valore ChassisID del commutatore è utilizzato da un'altra porta. Eseguire il comando seguente per trovare i valori ChassisID utilizzati dalle porte: Get-CsLisPort | Select-Object ChassisID. È necessario rimuovere per prima cosa tutte le porte con il ChassisID specificato, prima di poter rimuovere il commutatore.
Se si tenta di rimuovere un commutatore che non esiste, non viene intrapresa alcuna azione e non vengono visualizzati messaggi di errore o di avviso.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsLisSwitch 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-CsLisSwitch"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
ChassisID |
Obbligatorio |
Stringa |
Indirizzo MAC (Media Access Control) del commutatore di rete. Questo valore presenta il formato nn-nn-nn-nn-nn-nn, ad esempio, 12-34-56-78-90-ab. |
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 non restituisce un valore. Rimuovere un oggetto di tipo System.Management.Automation.PSCustomObject.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsLisSwitch -ChassisID 99-99-99-99-99-99
Nell'esempio 1 viene rimosso il commutatore LIS con indirizzo MAC (ChassisID) 99-99-99-99-99-99.
Se una porta fa riferimento a questo ChassisID, l'operazione non riesce. Inoltre, se al commutatore era associata una posizione, quest'ultima non viene rimossa; solo il commutatore viene rimosso dalla mappatura delle posizioni.
-------------------------- Esempio 2 --------------------------
Get-CsLisSwitch | Where-Object {$_.City -eq ""} | Remove-CsLisSwitch
In questo esempio vengono rimossi tutti i commutatori per cui non è indicata una città. L'esempio inizia con una chiamata al cmdlet Get-CsLisSwitch, che restituisce una raccolta di tutti i commutatori. La raccolta viene inviata tramite pipe al cmdlet Where-Object, che trova tutti gli elementi della raccolta con proprietà City vuota, ovvero una proprietà City uguale a (-eq) una stringa vuota (""). Questa raccolta di commutatori con proprietà City vuota infine viene inviata tramite pipe al cmdlet Remove-CsLisSwitch, che rimuove tutti gli oggetti della raccolta.
Analogamente all'esempio 1, dal database delle posizioni non viene rimossa alcuna posizione. Vengono rimossi unicamente i commutatori che fanno riferimento a tali posizioni. In questo caso, tutto ciò comporta che nel database delle posizioni ci saranno delle posizioni non valide, poiché la proprietà City è obbligatoria per le posizioni, che dovranno essere rimosse. È possibile rimuovere le posizioni chiamando il cmdlet Remove-CsLisLocation.