Set-CsAccessEdgeConfiguration
Ultima modifica dell'argomento: 2012-03-26
Modifica i valori di proprietà di una raccolta esistente delle impostazioni di configurazione di Access Edge Server per computer che eseguono servizio Access Edge. Il servizio servizio Access Edge in esecuzione in tali computer (definiti anche Edge Server) consente agli utenti all'esterno della rete interna di comunicare con gli utenti all'interno della rete interna.
Sintassi
Set-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousUsers <$true | $false>] [-AllowFederatedUsers <$true | $false>] [-AllowOutsideUsers <$true | $false>] [-Confirm [<SwitchParameter>]] [-EnableArchivingDisclaimer <$true | $false>] [-Force <SwitchParameter>] [-KeepCrlsUpToDateForPeers <$true | $false>] [-MarkSourceVerifiableOnOutgoingMessages <$true | $false>] [-OutgoingTlsCountForFederatedPartners <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsAccessEdgeConfiguration [-AllowAnonymousUsers <$true | $false>] [-AllowFederatedUsers <$true | $false>] [-AllowOutsideUsers <$true | $false>] [-BeClearingHouse <$true | $false>] [-Confirm [<SwitchParameter>]] [-EnableArchivingDisclaimer <$true | $false>] [-EnablePartnerDiscovery <$true | $false>] [-Force <SwitchParameter>] [-KeepCrlsUpToDateForPeers <$true | $false>] [-MarkSourceVerifiableOnOutgoingMessages <$true | $false>] [-OutgoingTlsCountForFederatedPartners <UInt32>] [-UseDnsSrvRouting <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsAccessEdgeConfiguration [-AllowAnonymousUsers <$true | $false>] [-AllowFederatedUsers <$true | $false>] [-AllowOutsideUsers <$true | $false>] [-Confirm [<SwitchParameter>]] [-DefaultRouteFqdn <String>] [-EnableArchivingDisclaimer <$true | $false>] [-Force <SwitchParameter>] [-IsPublicProvider <$true | $false>] [-KeepCrlsUpToDateForPeers <$true | $false>] [-MarkSourceVerifiableOnOutgoingMessages <$true | $false>] [-OutgoingTlsCountForFederatedPartners <UInt32>] [-UseDefaultRouting <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
Set-CsAccessEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Gli Edge Server (definiti anche server proxy di accesso) consentono agli utenti di estendere le funzionalità di Microsoft Lync Server 2010 agli utenti che non hanno effettuato l'accesso alla rete interna. Ad esempio, in caso di utenti remoti, i quali sono utenti autenticati che effettuano l'accesso a Lync Server tramite Internet piuttosto che tramite la rete interna, sarà necessario configurare un Edge Server al fine di consentire l'accesso a questi utenti. Analogamente, i server perimetrali sono obbligatori se si intende stabilire la federazione con un'altra organizzazione o assegnare agli utenti i diritti per comunicare con persone che possiedono account con un servizio di messaggistica istantanea quale Yahoo!, AOL o MSN. Gli Access Edge Server sono presenti sulla rete perimetrale e vengono utilizzati per effettuare e convalidare le connessioni SIP tra gli utenti all'interno e all'esterno della rete interna.
In Lync Server 2010, gli Access Edge Server vengono gestiti utilizzando una singola raccolta globale delle impostazioni di configurazione e il cmdlet Set-CsAccessEdgeConfiguration consente di modificare tali impostazioni globali. Le proprietà possono essere modificate a seconda del tipo di routing selezionato per i server perimetrali. Ad esempio, se si sceglie di utilizzare il routing del servizio Domain Name System (DNS), sarà possibile visualizzare e modificare i valori di proprietà BeClearinghouse ed EnablePartnerDiscovery. Se si utilizza il routing predefinito, questi due valori di proprietà non saranno disponibili. Sarà invece possibile visualizzare e modificare i valori di proprietà VerificationLevel ed IsPublicProvider.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Set-CsAccessEdgeConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAccessEdgeConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
L'identificatore univoco delle impostazioni di configurazione di Access Edge da restituire. Poiché è possibile avere esclusivamente una singola istanza globale di queste impostazioni, non è necessario includere il parametro Identity quando si esegue la chiamata a Set-CsAccessEdgeConfiguration. Tuttavia, per modificare le impostazioni globali è possibile utilizzare la seguente sintassi: -Identity global. |
Instance |
Facoltativo |
Oggetto DisplayAccessEdgeSettingsDnsSrvRouting o DisplayAccessEdgeSettingsDefaultRoute |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
AllowAnonymousUsers |
Facoltativo |
Booleano |
Indica se agli utenti anonimi (ovvero gli utenti non autenticati) è consentito attraversare il firewall e partecipare alle riunioni e alle conferenze. Il valore predefinito è False. |
AllowFederatedUsers |
Facoltativo |
Booleano |
Indica se agli utenti interni è consentito comunicare con gli utenti dei domini federati. Questa proprietà determina inoltre se gli utenti interni possono comunicare con gli utenti in uno scenario di dominio diviso. (In un dominio diviso, alcuni utenti dispongono di account ospitati a livello locale, mentre altri utenti dispongono di account ospitati in remoto). Il valore predefinito è False. |
AllowOutsideUsers |
Facoltativo |
Booleano |
Indica se gli utenti possono accedere a Lync Server tramite Internet, includendo sia gli utenti anonimi sia gli utenti remoti che tentano di accedere al sistema. Il valore predefinito è True. |
BeClearinghouse |
Facoltativo |
Booleano |
Indica se gli Edge Server vengono connessi direttamente ad altre organizzazioni. Il valore predefinito è False. Non è consigliabile modificare questo parametro, a meno che non siano state fornite istruzioni in merito dal personale di supporto Microsoft. |
DefaultRouteFqdn |
Facoltativo |
FQDN |
Il nome di dominio completo (FQDN) del server utilizzato per le richieste della federazione. Questo parametro è obbligatorio se si utilizza il routing predefinito. |
EnableArchivingDisclaimer |
Facoltativo |
Booleano |
Se impostato su True, i server perimetrali inviano l'intestazione della notifica dell'archiviazione ai partner federati e ai partner fornitori di servizi di accesso a terze parti. Questa notifica (la quale informa gli utenti che le conversazioni di messaggistica istantanea potrebbero essere archiviate) può essere visualizzata nella finestra di conversazione di un utente federato o di un utente fornitore di servizi di accesso a terze parti. Il valore predefinito è False. |
EnablePartnerDiscovery |
Facoltativo |
Booleano |
Se True, Lync Server utilizzerà i record DNS per provare ed individuare i domini partner non riportati nell'elenco AllowedDomains. Se False, Lync Server attuerà esclusivamente la federazione con i domini individuati nell'elenco AllowedDomains. Questo parametro è obbligatorio se si utilizza il routing del servizio DNS. Il valore predefinito è False. |
IsPublicProvider |
Facoltativo |
Booleano |
Deve essere impostato su True se la route predefinita richiede una licenza di messaggistica istantanea pubblica. |
KeepCrlsUpToDateForPeers |
Facoltativo |
Booleano |
Determina se gli Edge Server effettuano un controllo periodico degli elenchi di revoche di certificati (CRL) per i certificati dei domini federati. Il valore predefinito è True. |
MarkSourceVerifiableOnOutgoingMessages |
Facoltativo |
Booleano |
Se True, i messaggi in uscita vengono contrassegnati come verificabili, consentendo ai domini federati di determinare il livello di verifica di ciascun messaggio. Se False, tutti i messaggi in uscita vengono contrassegnati come non verificabili. Il valore predefinito è True. |
OutgoingTlsCountForFederatedPartners |
Facoltativo |
Numero intero |
Specifica il numero massimo di connessioni Transport Layer Security (TLS) che possono essere utilizzate per ciascun partner federato. Il numero minimo di connessioni TLS è 1 e il numero massimo è 4. Per impostazione predefinita, OutgoingTlsCountForFederatedPartners è impostato su 4. Non è consigliabile modificare questo parametro, a meno che non siano state fornite istruzioni in merito dal personale di supporto Microsoft. |
UseDefaultRouting |
Facoltativo |
Parametro opzionale |
Indica che gli amministratori devono specificare il nome di dominio completo del server utilizzato per inviare e ricevere richieste della federazione. Se si include il parametro UseDefaultRouting, è necessario includere anche il parametro DefaultRouteFqdn. |
UseDnsSrvRouting |
Facoltativo |
Parametro opzionale |
Indica che gli Edge Server dovrebbero basarsi sui record SRV DNS durante l'invio e la ricezione delle richieste della federazione. Questo è il metodo di routing predefinito. |
VerificationLevel |
Facoltativo |
Modificatore elenco PS |
Se si utilizza il routing predefinito, la proprietà VerificationLevel viene utilizzata per monitorare e valutare il livello di verifica dei messaggi in arrivo. I valori validi sono: AlwaysVerifiable: tutte le richieste ricevute sulla route predefinita vengono contrassegnate come verificate. Se l'intestazione della verifica non è presente, verrà aggiunta automaticamente al messaggio. AlwaysUnverifiable: i messaggi vengono inviati solo se il destinatario (l'utente al quale è destinato il messaggio) ha configurato una voce di controllo di accesso per la persona che ha inviato il messaggio. UseSourceVerification: la verifica dei messaggi si basa sul livello di verifica incluso nel messaggio. Se non è presente alcuna intestazione della verifica, il messaggio verrà contrassegnato come non verificato. |
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
Nessuno. Set-CsAccessEdgeConfiguration non accetta input inviato tramite pipe.
Tipi restituiti
Set-CsAccessEdgeConfiguration non restituisce alcun oggetto o valore.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsAccessEdgeConfiguration -AllowAnonymousUsers $True -VerificationLevel "UseSourceVerification"
Nell'esempio 1 vengono modificate due proprietà delle impostazioni di configurazione dell'Access Edge Server: la proprietà AllowAnonymousUsers è impostata su True e la proprietà VerificationLevel è impostata su UseSourceVerification.
-------------------------- Esempio 2 ------------------------
Set-CsAccessEdgeConfiguration -UseDefaultRouting -DefaultRouteFqdn "atl-edge-001.litwareinc.com"
Il comando indicato nell'esempio 2 consente di modificare il metodo di routing per l'Edge Server in routing predefinito. A tale scopo, il comando deve includere sia il parametro UseDefaultRouting che il parametro DefaultRouteFqdn, insieme al valore del parametro che specifica il nome di dominio completo dell'Edge Server.
-------------------------- Esempio 3 ------------------------
Set-CsAccessEdgeConfiguration -UseDnsSrvRouting -EnablePartnerDiscovery $True
Il comando precedente consente di modificare il metodo di routing per l'Edge Server in routing del server DNS. Questo richiede l'utilizzo di due parametri: UseDnsSrvRouting (senza alcun valore del parametro) ed EnablePartnerDiscovery (con il valore del parametro $True).