Condividi tramite

  • Articolo

Set-CsBlockedDomain

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare la proprietà Comment per uno o più domini inclusi nell'elenco di 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 l'account SIP nel dominio sull'elenco bloccato.

Sintassi

Set-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsBlockedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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 stabilita una federazione, gli utenti delle due organizzazioni possono inviarsi messaggi istantanei, sottoscrivere l'opzione di notifiche di 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 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 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 bloccato rappresenta i domini ai quali viene espressamente proibito agli utenti di federarsi, ad esempio un messaggio inviato da un dominio bloccato viene automaticamente rifiutato da Lync Server 2010.

La proprietà Comment, la sola proprietà di un dominio bloccato che è possibile modificare, viene utilizzata per archiviare ulteriori informazioni sul dominio in questione, ad esempio, il motivo per cui è stato bloccato, quando può essere eliminato dall'elenco dei domini bloccati, chi contattare per richiedere l'eliminazione del dominio dall'elenco dei domini bloccati e così via. Per modificare la proprietà Comment per uno qualsiasi dei domini bloccati, utilizzare il cmdlet Set-CsBlockedDomain.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsBlockedDomain può essere utilizzato localmente dai membri dei seguenti gruppi: 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 "Set-CsBlockedDomain"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Stringa

Nome completo (FQDN) del dominio bloccato del quale viene modificata la proprietà Comment. Ad esempio: fabrikam.com

Instance

Facoltativo

Oggetto BlockedDomain

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

Comment

Facoltativo

Stringa

Consente di fornire ulteriori informazioni sul dominio da modificare. Ad esempio, è possibile aggiungere un commento (Comment) che spiega perché il dominio è stato inserito nell'elenco dei domini bloccati.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain. Set-CsBlockedDomain accetta le istanze dell'oggetto dominio bloccato inviate tramite pipeline.

Tipi restituiti

Set-CsBlockedDomain non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain.

Esempio

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

Set-CsBlockedDomain -Identity fabrikam.com -Comment "Block this domain pending legal review."

Il comando riportato nell'Esempio 1 consente di modificare il commento (Comment) per il dominio bloccato con Identity "fabrikam.com". In questo esempio, viene incluso il parametro Comment con il valore "Block this domain pending legal review".

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

Get-CsBlockedDomain | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

Nell'esempio precedente, la proprietà Comment viene aggiornata per tutti i domini inclusi nell'elenco dei domini bloccati. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsBlockedDomain per restituire una raccolta di tutti i domini attualmente inclusi nell'elenco dei domini bloccati. La raccolta viene quindi inviata tramite pipe al cmdlet Set-CsBlockedDomain che modifica la proprietà Comment di ciascun dominio della raccolta.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

Nell'Esempio 3, un nuovo commento ("Block this domain pending legal review.") viene aggiunto a ciascun dominio nell'elenco dei domini bloccati per il quale non è già stato configurato un valore per la proprietà Comment. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsBlockedDomain per restituire una raccolta di tutti i domini attualmente inclusi 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. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsBlockedDomain che assegna lo stesso commento alla proprietà Comment di ciascun dominio della raccolta filtrata.