Condividi tramite

  • Articolo

Get-CsAllowedDomain

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sui domini inclusi nell'elenco dei domini approvati per la federazione. Dopo l'approvazione di un dominio per la federazione, ovvero l'aggiunta del dominio nell'elenco dei domini consentiti, gli utenti possono scambiarsi messaggi istantanei e informazioni sulla presenza con persone che dispongono di account in quel dominio.

Sintassi

Get-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAllowedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

La federazione è un mezzo tramite il quale due organizzazioni possono instaurare una relazione di trust che facilita la comunicazione tra i due gruppi. Quando viene creata una federazione, gli utenti delle due organizzazioni possono scambiare messaggi istantanei, sottoscrivere i servizi di notifica della presenza e comunicare in altri modi tra loro utilizzando le applicazioni SIP (ad esempio, Microsoft Lync 2010). Microsoft Lync Server 2010 supporta tre tipi di federazione: 1) federazione diretta tra la propria e un'altra organizzazione; 2) federazione tra la propria organizzazione e un provider pubblico; 3) federazione tra la propria organizzazione e un provider di hosting terzo.

La configurazione di una federazione con un'altra organizzazione implica diverse attività. Per iniziare si deve abilitare il proprio Access Edge Server per consentire la federazione. Inoltre, l'altra organizzazione deve a sua volta abilitare il processo federativo; la federazione non può essere instaurata se entrambe le parti non sono d'accordo.

Per impostare una relazione federata potrebbe inoltre essere necessario gestire due elenchi relativi alla federazione: l'elenco dei domini consentiti e quello dei domini bloccati. L'elenco consentito (necessario se è stato disabilitato EnablePartnerDiscovery) rappresenta l'organizzazione con la quale si è deciso di federarsi. Se un dominio compare nell'elenco consentito (dipende dalle impostazioni di configurazione) gli utenti saranno in grado di scambiarsi messaggi istantanei e informazioni sulla presenza con utenti in possesso di un account nel dominio federato. Al contrario, l'elenco dei domini bloccati rappresenta i domini ai quali gli utenti non sono autorizzati a federarsi (ad esempio, i messaggi inviati da un dominio bloccato verranno automaticamente rifiutati da Lync Server 2010).

Il cmdlet Get-CsAllowedDomain consente di ottenere informazioni su tutti i domini inclusi nell'elenco dei domini consentiti.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsAllowedDomain può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAllowedDomain"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Il nome del dominio da ottenere. Nell'elenco dei domini consentiti, i domini sono riportati con il loro nome completo (FQDN); pertanto, l'identità di un dominio potrebbe essere fabrikam.com o contoso.net e non è possibile utilizzare i caratteri jolly per specificarla. Per utilizzare i caratteri jolly per ottenere un determinato dominio o gruppo di domini è necessario utilizzare il parametro Filter.

Se questo parametro non viene specificato, verranno restituiti tutti i domini inclusi nell'elenco dei domini consentiti.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per ottenere uno o più domini dall'elenco dei domini consentiti. Per ottenere tutti i domini che hanno un'identità che inizia con la lettera "r", utilizzare la seguente sintassi: -Filter r*. Per ottenere tutti i domini con un'identità che termina con ".net", utilizzare la seguente sintassi: -Filter "*.net". Per ottenere tutti i domini che hanno un'identità che inizia con la lettera "r" o la lettera "g", utilizzare la seguente sintassi: -Filter [rg]*.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i domini consentiti dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsAllowedDomain non accetta input tramite pipeline.

Tipi restituiti

Restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Esempio

-------------------------- Esempio 1 --------------------------

Get-CsAllowedDomain

Il comando precedente restituisce una raccolta di tutti i domini inclusi nell'elenco dei domini approvati per la federazione. Utilizzando il cmdlet Get-CsAllowedDomain senza ulteriori parametri viene restituita sempre la raccolta completa di domini approvati.

-------------------------- Esempio 2 --------------------------

Get-CsAllowedDomain -Identity fabrikam.com

Nell'Esempio 2 vengono restituite le informazioni sul dominio consentito con Identity "fabrikam.com". Poiché le identità devono essere univoche, il comando non restituirà mai più di un elemento.

-------------------------- Esempio 3 --------------------------

Get-CsAllowedDomain -Filter *fabrikam*

Il comando riportato nell'Esempio 3 restituisce una raccolta di tutti i domini consentiti che contengono la stringa "fabrikam" in qualunque punto della loro identità. A tal fine, il comando utilizza il parametro Filter e il valore del filtro "*fabrikam*". Questo valore di filtro consente a Get-CsAllowedDomain di restituire solo quei domini in cui l'identità (la sola proprietà su cui è possibile applicare il filtro) include il valore di stringa "fabrikam". Domini quali fabrikam.com, fabrikam.net e africa.fabrikam.org verranno tutti restituiti da questo comando.

-------------------------- Esempio 4 --------------------------

Get-CsAllowedDomain | Where-Object {$_.ProxyFqdn -eq $Null}

Nell'Esempio 4, vengono utilizzati i cmdlet Get-CsAllowedDomain e Where-Object per ottenere una raccolta di domini per i quali non è stato impostato alcun valore per la proprietà ProxyFqdn. Per eseguire questa operazione, il comando utilizza prima il cmdlet Get-CsAllowedDomain senza parametri aggiuntivi per ottenere una raccolta di tutti i domini consentiti. Questa raccolta viene inviata tramite pipe a Where-Object, che seleziona solo quei domini consentiti in cui la proprietà ProxyFqdn è uguale ad un valore nullo; un valore nullo significa che non è stato immesso nessun valore per ProxyFqdn. Invece, per trovare tutti i domini che hanno un valore qualunque configurato per la proprietà ProxyFqdn, utilizzare la seguente sintassi:

Where-Object {$_.ProxyFqdn -ne $Null}

-------------------------- Esempio 5 --------------------------

Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $True}

Il comando precedente restituisce tutti i domini consentiti il cui stato di integrità è stato verificato da Monitoring Server. A tal fine, viene prima utilizzato il cmdlet Get-CsAllowedDomain per ottenere una raccolta di tutti i domini inclusi nell'elenco dei domini consentiti. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo quei domini in cui la proprietà MarkForMonitoring è uguale a True.