Remove-CsSipDomain
Ultima modifica dell'argomento: 2012-03-27
Rimuove un dominio SIP precedentemente configurato per l'utilizzo nell'organizzazione. I domini SIP sono domini autorizzati a inviare e a ricevere traffico SIP e vengono utilizzati per l'assegnazione di indirizzi SIP agli utenti.
Sintassi
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Per configurare gli indirizzi SIP per gli utenti (e abilitarli quindi all'utilizzo di software correlato a SIP, ad esempio Microsoft Lync 2010), sono necessarie due informazioni: un ID utente (ad esempio Ken.Myer) e un dominio SIP (ad esempio litwareinc.com). Il dominio SIP utilizzato per creare un indirizzo SIP deve essere un dominio situato all'interno della foresta di Active Directory autorizzato per l'invio e la ricezione di traffico SIP. Si supponga ad esempio di disporre di domini denominati litwareinc.com, fabrikam.com e contoso.com, ma che solo litwareinc.com sia stato identificato come dominio SIP. In tal caso, non è possibile utilizzare un indirizzo SIP come sip:Ken.Myer@fabrikam.com o sip:Ken.Myer@contoso.com, almeno fino a quando fabrikam.com e contoso.com non siano stati configurati come domini SIP validi. Questa operazione può essere effettuata eseguendo il cmdlet New-CsSipDomain.
Dopo che un dominio SIP è stato autorizzato, l'autorizzazione può essere annullata utilizzando il cmdlet Remove-CsSipDomain. Questo cmdlet rimuove dall'elenco dei domini SIP approvati il dominio specificato. Non è possibile tuttavia rimuovere il dominio predefinito. Qualora sia necessario procedere in tal senso, configurare innanzitutto un altro dominio SIP come dominio predefinito. Se si dispone di un solo dominio SIP, esso verrà automaticamente configurato come dominio predefinito e non sarà possibile rimuoverlo.
Non è possibile inoltre rimuovere un dominio SIP a cui sono stati assegnati uno o più indirizzi SIP. Non è possibile ad esempio rimuovere Contoso.com come dominio SIP se Davide Garghentini dispone dell'indirizzo SIP "sip:davidegarghentini@contoso.com". Per rimuovere un dominio SIP attualmente in uso, è necessario innanzitutto assegnare nuovi indirizzi SIP a tutti gli utenti che utilizzano tale dominio nel proprio indirizzo SIP.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsSipDomain 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-CsSipDomain"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del dominio SIP da rimuovere, ad esempio -Identity fabrikam.com. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
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
Oggetto Microsoft.Rtc.Management.Xds.SipDomain. Remove-CsSipDomain accetta le istanze da pipeline dell'oggetto dominio SIP.
Tipi restituiti
Nessuno. Remove-CsSipDomain piuttosto elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.SipDomain.
Esempio
-------------------------- Esempio 1 ------------------------
Remove-CsSipDomain -Identity fabrikam.com
Il comando precedente rimuove il dominio SIP con valore Identity fabrikam.com dall'elenco dei nomi di dominio supportati. Il comando avrà esito negativo se fabrikam.com è l'unico dominio SIP attualmente in uso nell'organizzazione. La topologia infatti deve includere almeno un dominio SIP.
-------------------------- Esempio 2 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
Il comando mostrato nell'esempio 2 elimina tutti i domini SIP all'interno dell'organizzazione, tranne il dominio predefinito. A tale scopo, il comando chiama innanzitutto Get-CsSipDomain per restituire una raccolta di tutti i domini SIP in uso. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i domini con proprietà IsDefault non uguale a True. Il risultato è che il dominio predefinito viene filtrato e i restanti domini vengono successivamente inviati tramite pipe a Remove-CsSipDomain ed eliminati.