Get-CsSipDomain
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sui domini SIP configurati per l'uso 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
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
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.
Il cmdlet Get-CsSipDomain consente di ottenere le informazioni sui domini SIP autorizzati per l'utilizzo nell'organizzazione. Get-CsSipDomain consente inoltre di identificare il dominio SIP predefinito per l'organizzazione, ovvero il dominio che verrà utilizzato da Microsoft Lync Server 2010, per impostazione predefinita, se non viene specificato un dominio SIP.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-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 "Set-CsSipDomain"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Stringa |
Nome di dominio completo del dominio SIP che si desidera venga restituito (ad esempio, fabrikam.com). Se non si specifica né questo parametro, né il parametro Filter, vengono restituiti tutti i domini SIP autorizzati per l'utilizzo nell'organizzazione. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare caratteri jolly per specificare l'identità del dominio o dei domini SIP da restituire. Ad esempio, il valore di filtro "*.org" restituisce una raccolta di tutti i domini SIP autorizzati la cui identità termina con il valore stringa ".org". |
Tipi di input
Nessuno. Get-CsSipDomain non accetta dati da pipeline.
Tipi restituiti
Get-CsSipDomain restituisce istanze dell'oggetto Microsoft.Rtc.Management.Xds.SipDomain.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsSipDomain
Con l'esempio 1 viene chiamato Get-CsSipDomain senza parametri; questo cmdlet restituisce le informazioni su tutti i domini SIP configurati per l'utilizzo nell'organizzazione.
-------------------------- Esempio 2 ------------------------
Get-CsSipDomain -Identity fabrikam.com
Il comando mostrato nell'esempio 2 restituisce le informazioni di ogni dominio SIP con Identity fabrikam.com. Poiché le identità dei domini SIP devono essere univoche, questo comando non restituisce mai più di un elemento.
-------------------------- Esempio 3 ------------------------
Get-CsSipDomain -Filter "f*"
Il comando precedente utilizza Get-CsSipDomain insieme al parametro Filter per restituire le informazioni su tutti i domini SIP la cui identità inizia con la lettera "f". Ad esempio: fabrikam.com, fabrikam.org, fabrikam-users.com e così via.
-------------------------- Esempio 4 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
Il comando mostrato nell'esempio 4 restituisce le informazioni sul dominio SIP predefinito. A questo scopo, viene innanzitutto chiamato Get-CsSipDomain senza alcun parametro per restituire una raccolta di tutti i domini SIP configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo un dominio in cui la proprietà IsDefault equivale a True.