Get-CsAccessEdgeConfiguration
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni riguardo le impostazioni di configurazione per i computer che eseguono servizio Access Edge nella propria organizzazione (noti anche come Access Edge server). Gli Access Edge Server consentono agli utenti esterni alla rete di comunicare con gli utenti interni alla rete.
Sintassi
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Gli Access Edge Server (noti anche con il nome di server proxy) consentono di estendere le funzionalità di Microsoft Lync Server 2010 a persone non connesse alla rete interna. Ad esempio, nel caso di utenti remoti, vale a dire utenti autenticati che accedono a Lync Server 2010 tramite Internet invece che tramite la rete interna, sarà necessario configurare Access Edge Server. Inoltre, gli Edge Server sono necessari se si desidera instaurare una federazione con un'altra organizzazione oppure se si desidera concedere ai propri utenti il diritto di comunicare con persone che hanno i propri account presso un servizio di messaggistica istantanea pubblico, come Yahoo!, AOL o MSN. Gli Access Edge Server risiedono sulla rete perimetrale e vengono utilizzati per stabilire e convalidare le connessioni SIP tra utenti che si trovano all'esterno e all'interno della rete interna.
In Lync Server, gli Access Edge Server vengono gestiti utilizzando un'unica raccolta globale di impostazioni di configurazione. Il cmdlet Get-CsAccessEdgeConfiguration consente di ottenere le informazioni relative a queste impostazioni globali. Si noti che i valori delle proprietà restituiti da Get-CsAccessEdgeConfiguration variano a seconda del tipo di instradamento configurato per gli Edge Server. Per informazioni dettagliate, vedere l'argomento della Guida Set-CsAccessEdgeConfiguration.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsAccessEdgeConfiguration 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-CsAccessEdgeConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Identificatore univoco delle impostazioni di configurazione dell'Access Edge Server da ottenere. Poiché è possibile avere una sola istanza globale di queste impostazioni, non è necessario includere l'identità quando si utilizza il cmdlet Get-CsAccessEdgeConfiguration. Tuttavia, è possibile utilizzare la sintassi riportata di seguito per recuperare le impostazioni globali: -Identity global. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per specificare le impostazioni di configurazione degli Access Edge Server da ottenere. Poiché esiste una sola istanza globale di queste impostazioni, il parametro Filter non è necessario. Tuttavia, se lo si preferisce, è possibile utilizzare una sintassi simile alla seguente per recuperare le impostazioni globali: -Identity "g*". |
LocalStore |
Facoltativo |
Parametro opzionale |
Consente di recuperare i dati di configurazione di Access Edge Server dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale. |
Tipi di input
Nessuno. Get-CsAccessEdgeConfiguration non accetta input tramite pipeline.
Tipi restituiti
Get-CsAccessEdgeConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting o dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsAccessEdgeConfiguration
L'Esempio 1 dimostra l'uso di base del cmdlet Get-CsAccessEdgeConfiguration: se si utilizza il cmdlet senza ulteriori parametri, vengono restituiti tutti i valori delle proprietà per l'implementazione degli Access Edge Server. Si noti che non è necessario includere il parametro Identity o Filter; questo perché esiste solo un'unica raccolta di dati di configurazione degli Access Edge Server.
-------------------------- Esempio 2 --------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
Il comando precedente restituisce solo tre valori delle proprietà per la configurazione degli Access Edge Server: AllowAnonymousUsers; AllowFederatedUsers; AllowOutsideUsers. Per ottenere questo risultato, il comando utilizza prima Get-CsAccessEdgeConfiguration per ottenere tutti i valori delle proprietà per gli Access Edge Server. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object che seleziona solo quelle proprietà che iniziano con la stringa "Allow". Quei valori sono gli unici valori delle proprietà visualizzati sullo schermo.
-------------------------- Esempio 3 --------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
Il comando riportato nell'Esempio 3 restituisce il valore di una singola proprietà di configurazione degli Access Edge Server: EnablePartnerDiscovery. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsAccessEdgeConfiguration per ottenere tutti i valori delle proprietà di configurazione degli Access Edge Server. L'utilizzo del cmdlet Get-CsAccessEdgeConfiguration è racchiuso tra parentesi; ciò garantisce che Windows PowerShell esegua questo comando prima di eseguire qualunque altra operazione. Una volta ottenuti tutti i valori delle proprietà, viene utilizzata la "notazione del punto" standard (nome dell'oggetto seguito da un punto seguito dal nome della proprietà) per visualizzare il valore di una singola proprietà: EnablePartnerDiscovery.