New-CsSipDomain
Ultima modifica dell'argomento: 2012-03-27
Consente di creare un nuovo dominio SIP da utilizzare nell'organizzazione. I domini SIP sono domini autorizzati a inviare e a ricevere traffico SIP e vengono utilizzati durante l'assegnazione degli indirizzi SIP agli utenti.
Sintassi
New-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Per configurare gli indirizzi SIP per gli utenti (e per abilitarli all'utilizzo del 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 costruire un indirizzo SIP deve essere un dominio situato all'interno della foresta di Active Directory, autorizzato per l'invio e la ricezione del traffico SIP. Si supponga, ad esempio, di disporre di domini chiamati 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 è possibile eseguendo il cmdlet New-CsSipDomain.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsSipDomain in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipDomain"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Stringa |
Nome di dominio completo per il nuovo dominio SIP. Ad esempio: -Identity fabrikam.com. |
IsDefault |
Facoltativo |
Booleano |
Indica se il dominio specificato è il dominio SIP predefinito, vale a dire il dominio utilizzato da Lync Server 2010 ogni volta che non viene esplicitamente specificato un dominio. Se impostato su True, il nuovo dominio diventa anche il nuovo dominio predefinito Il valore predefinito per IsDefault è False. Se non si vuole rendere il nuovo dominio il dominio predefinito, lasciare il parametro vuoto. |
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. New-CsSipDomain non accetta dati da pipeline.
Tipi restituiti
New-CsSipDomain consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.Xds.SipDomain.
Esempio
-------------------------- Esempio 1 ------------------------
New-CsSipDomain -Identity fabrikam.com
Il comando riportato nell'Esempio 1 consente di creare un nuovo dominio SIP che ha come identità fabrikam.com.
-------------------------- Esempio 2 ------------------------
New-CsSipDomain -Identity fabrikam.com -IsDefault $True
Il comando precedente crea un nuovo dominio SIP denominato fabrikam.com e rende questo nuovo dominio il dominio SIP predefinito. Impostando fabrikam.com come dominio predefinito, il comando "abbassa di livello" il dominio che in precedenza rappresentava il dominio SIP predefinito. Questa operazione è dovuta al fatto che è possibile avere un solo dominio SIP predefinito.