Condividi tramite

  • Articolo

Get-CsBlockedDomain

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sui domini inclusi nell'elenco dei domini bloccati per la federazione. Per definizione, agli utenti non è consentito utilizzare le applicazioni di Microsoft Lync Server 2010 per comunicare con altri utenti dal dominio bloccato; ad esempio, gli utenti non possono utilizzare Microsoft Lync 2010 per scambiare messaggi istantanei con altri utenti con un account SIP (Session Initiation Protocol) in un dominio presente nell'elenco di quelli bloccati.

Sintassi

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

Get-CsBlockedDomain [-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, Lync 2010). 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, è necessario configurare il servizio Access Edge di Lync 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 dei domini consentiti rappresenta l'organizzazione con la quale si è scelto di federarsi; se un dominio è incluso in questo elenco, gli utenti, subordinatamente alle impostazioni di configurazione, saranno in grado di scambiare messaggi istantanei e informazioni sulla presenza con gli utenti che hanno l'account su quel 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-CsBlockedDomain consente di ottenere le informazioni sui domini che fanno parte dell'elenco dei domini bloccati.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsBlockedDomain 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-CsBlockedDomain"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Il nome del dominio da ottenere. Nell'elenco dei domini bloccati, i domini sono riportati con il loro nome completo (FQDN); pertanto, l'identità di un dominio potrebbe essere simile a 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 bloccati.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per ottenere uno o più domini dall'elenco dei domini bloccati. 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 "f" o la lettera "g", utilizzare la seguente sintassi: -Filter [fg]*.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati dei domini bloccati dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsBlockedDomain non accetta input tramite pipeline.

Tipi restituiti

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

Esempio

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

Get-CsBlockedDomain

Il comando riportato nell'Esempio 1 consente di ottenere una raccolta di tutti i domini presenti nell'elenco dei domini bloccati. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsBlockedDomain senza alcun parametro aggiuntivo.

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

Get-CsBlockedDomain -Identity fabrikam.com

Nell'Esempio 2 l'unico dominio bloccato restituito è quello con l'identità "fabrikam.com". Dal momento che i domini nell'elenco dei domini bloccati devono avere identità univoche, il comando restituirà al massimo un unico elemento.

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

Get-CsBlockedDomain -Filter *.net

Nell'Esempio 3 viene utilizzato il parametro Filter per ottenere una raccolta di tutti i domini bloccati la cui identità termina con il valore ".net". Questo comando restituisce domini come northwindtraders.net, contoso.net e fabrikam.net.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null}

Il comando precedente restituisce una raccolta di tutti i domini in cui la proprietà Comment non presenta valori. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsBlockedDomain per ottenere una raccolta di tutti i domini nell'elenco dei domini bloccati. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei domini in cui la proprietà Comment è uguale a Null.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -match "Ken Myer"}

Nell'Esempio 5 vengono restituiti tutti i domini bloccati che includono il valore "Davide Garghentini" nella proprietà Comment. Per eseguire questa operazione, viene utilizzato il cmdlet Get-CsBlockedDomain per ottenere una raccolta di tutti i domini nell'elenco dei domini bloccati. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei domini in cui la proprietà Comment contiene il valore "Davide Garghentini".