Condividi tramite

  • Articolo

Set-CsAllowedDomain

 

Ultima modifica dell'argomento: 2012-03-27

Modifica i valori delle proprietà per uno o più 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 scambiare messaggi istantanei e informazioni sulla presenza con persone che dispongono di account nel dominio federato.

Sintassi

Set-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Set-CsAllowedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La federazione è un mezzo per stabilire una relazione di trust tra due organizzazioni per agevolare la comunicazione tra i due gruppi. Una volta stabilita una federazione, gli utenti delle due organizzazioni possono scambiare messaggi istantanei, sottoscrivere l'opzione di notifiche di presenza e comunicare comunque tra loro utilizzando le applicazioni SIP, ad esempio Microsoft Lync 2010. Microsoft Lync Server 2010 supporta tre tipi di federazione: 1) federazione diretta tra due organizzazioni; 2) federazione tra un'organizzazione e un provider pubblico; e 3) federazione tra un'organizzazione e un provider di hosting di terze parti.

l'impostazione di una federazione diretta con altre organizzazioni richiede diverse attività. Per iniziare, è necessario configurare i server che eseguono il servizio Access Edge di Lync Server in modo da consentire la federazione. Inoltre, anche l'altra organizzazione deve abilitare la federazione; non è possibile stabilire una federazione, a meno che entrambe le parti non siano concordi nell'impostare una relazione.

Per stabilire una relazione federata, potrebbe inoltre essere necessario gestire due elenchi correlati alla federazione: l'elenco consentito e l'elenco bloccato. l'elenco dei domini consentiti rappresenta le organizzazioni con cui si è scelto di stabilire una relazione federata. Se un dominio è presente nell'elenco dei domini consentiti, a seconda delle impostazioni di configurazione gli utenti potranno scambiare messaggi istantanei e informazioni sulla presenza con utenti che dispongono di account in tale dominio federato. l'elenco dei domini bloccati invece rappresenta i domini con i quali è espressamente vietato agli utenti di stabilire una federazione. I messaggi provenienti da un dominio bloccato ad esempio verranno automaticamente rifiutati da Lync Server 2010.

Il cmdlet Set-CsAllowedDomain consente di modificare i valori delle proprietà di un domino presente nell'elenco dei domini consentiti.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsAllowedDomain i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Stringa

Nome di dominio completo (FQDN) del dominio consentito di cui vengono modificati i valori delle proprietà, ad esempio

-Identity fabrikam.com

Instance

Facoltativo

Oggetto dominio bloccato

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

Comment

Facoltativo

Stringa

Valore stringa facoltativo che fornisce ulteriori informazioni sul dominio da modificare. È ad esempio possibile aggiungere un commento che fornisce le informazioni di contatto del dominio federato.

MarkForMonitoring

Facoltativo

Booleano

Indica se la connessione di federazione tra il dominio e il dominio remoto verrà monitorata da Monitoring Server. Per impostazione predefinita, MarkForMonitoring è impostato su False, ovvero la connessione non sarà monitorata.

Questa proprietà verrà ignorata se Monitoring Server non è stato distribuito.

ProxyFqdn

Facoltativo

FQDN

Nome di dominio completo (ad esempio proxy-server.fabrikam.com) del server proxy SIP distribuito nel dominio che deve essere aggiunto all'elenco dei domini consentiti. Questa proprietà è facoltativa. Se non viene specificata, verranno utilizzate le procedure di individuazione DNS SRV per determinare la posizione del server proxy SIP.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'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.AllowedDomain. Set-CsAllowedDomain accetta le istanze da pipeline dell'oggetto dominio consentito.

Tipi restituiti

Set-CsAllowedDomain non restituisce un valore o un oggetto. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Esempio

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

Set-CsAllowedDomain -Identity fabrikam.com -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"

Il comando mostrato nell'esempio 1 modifica la proprietà Comment per il dominio consentito con "fabrikam.com" come valore per il parametro Identity. A tale scopo, viene incluso il parametro Comment con il valore di parametro appropriato: "Contact: Davide Garghentini (davidegarghentini@fabrikam.com)".

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

Get-CsAllowedDomain -Filter *fabrikam* | Set-CsAllowedDomain -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)" -MarkForMonitoring $True

Con il comando precedente vengono modificate le proprietà Comment e MarkForMonitoring di tutti i domini consentiti con il valore stringa "fabrikam" all'interno del parametro Identity. Per eseguire questa attività, il comando chiama innanzitutto Get-CsAllowedDomain e il parametro Filter. Il valore di filtro "*fabrikam*" indica a Get-CsAllowedDomain di restituire tutti i domini con valore Identity che include il valore stringa "fabrikam". Questo comando restituisce, ad esempio, i domini come fabrikam.com, us.fabrikam.net e fabrikam-users.org. La raccolta filtrata viene quindi inviata tramite pipe a Set-CsAllowedDomain, che modifica la proprietà Comment e imposta la proprietà MarkForMonitoring su True ($True) per ogni elemento della raccolta.

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

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

Il comando riportato nell'esempio 3 modifica tutti i domini presenti nell'elenco dei domini consentiti che non sono attualmente monitorati da Monitoring Server, ovvero tutti i domini con proprietà MarkForMonitoring impostata su False. A tale scopo, viene chiamato Get-CsAllowedDomain senza parametri aggiuntivi per recuperare una raccolta di tutti i domini presenti nell'elenco dei domini consentiti. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i domini con valore MarkForMonitoring uguale a False. La raccolta filtrata viene quindi inviata tramite pipe a Set-CsAllowedDomain, che imposta la proprietà MarkForMonitoring per ogni dominio della raccolta su True.

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

Get-CsAllowedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsAllowedDomain -Comment "Need contact information."

Nell'esempio 4 viene aggiunto un commento generico ("Need contact information.") a ogni dominio presente nell'elenco dei domini consentiti in cui la proprietà Comment non contiene attualmente alcun valore. Per eseguire questa attività, il comando chiama innanzitutto Get-CsAllowedDomain per recuperare una raccolta di tutti i domini presenti nell'elenco dei domini consentiti. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona i domini con proprietà Comment uguale a Null. La raccolta filtrata viene quindi inviata tramite pipe a Set-CsAllowedDomain, che modifica la proprietà Comment di ogni elemento della raccolta.