Set-CsSipDomain
Ultima modifica dell'argomento: 2012-03-27
Consente di modificare i valori delle proprietà dei domini SIP dell'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
Set-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-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.
È necessario disporre sempre di un dominio SIP configurato come dominio predefinito. Il cmdlet Set-CsSipDomain consente di cambiare il dominio SIP predefinito.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-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 "Set-CsSipDomain"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del dominio SIP da configurare come dominio predefinito, ad esempio -Identity fabrikam.com. |
IsDefault |
Facoltativo |
Booleano |
Indica se il dominio specificato è il dominio SIP predefinito, ovvero il dominio utilizzato da Lync Server 2010 ogni volta che non viene esplicitamente specificato un dominio. Se impostato su True, il nuovo dominio diventerà il nuovo dominio predefinito Non è possibile impostare questo valore su False, poiché si rimarrebbe senza un dominio SIP predefinito. |
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
Nessuno. Set-CsSipDomain non accetta dati da pipeline.
Tipi restituiti
Set-CsSipDomain non restituisce alcun oggetto o valore. Il cmdlet piuttosto viene utilizzato per modificare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.SipDomain.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
Il comando riportato nell'esempio 1 indica il dominio SIP fabrikam.com come dominio SIP predefinito. Questa operazione viene eseguita tramite il parametro IsDefault e il valore di parametro $True. Una volta eseguito questo comando, Fabrikam.com diventerà il dominio predefinito e il precedente dominio predefinito verrà abbassato di livello. È possibile infatti disporre di un solo dominio predefinito.