Get-CsAccessEdgeConfiguration
Tópico modificado em: 2012-03-23
Retorna informações sobre as definições de configuração de computadores executando o Serviço de Borda de Acesso em sua organização (também conhecidos como servidores de borda de acesso). Os Servidores de Borda de Acesso fornecem uma forma de os usuários fora da rede interna se comunicarem com usuários na rede interna.
Sintaxe
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Os Servidores de Borda de Acesso (também conhecidos como servidores proxy de acesso) fornecem uma forma para você estender os recursos do Microsoft Lync Server 2010 até pessoas não conectados à rede interna. Por exemplo, se tiver usuários remotos--usuários autenticados que fazem logon no Lync Server 2010 pela Internet, e não pela rede interna--, você precisará configurar um Servidor de Borda de Acesso. Além disso, os Servidores de Borda serão obrigatórios se você quiser estabelecer uma federação com outra organização, ou quiser dar aos usuários o direito de se comunicar com pessoas que tenham contas em um serviço do sistema de mensagens instantâneas público, como Yahoo!, AOL ou MSN. Os Servidores de Borda de Acesso ficam na rede de perímetro e são usados para estabelecer e validar conexões SIP entre usuários dentro e fora da rede interna.
No Lync Server, os Servidores de Borda de Acesso são gerenciados usando-se uma coleção global única de definições de configuração. O cmdlet Get-CsAccessEdgeConfiguration permite retornar informações sobre essas configurações globais. Observe que os valores de propriedade retornados pelo Get-CsAccessEdgeConfiguration irão variar de acordo com o tipo de roteamento configurado para Servidores de Borda. Para detalhes, consulte o tópico de Ajuda Set-CsAccessEdgeConfiguration.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsAccessEdgeConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAccessEdgeConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Identificador exclusivo das definições de configuração da Borda de Acesso a serem retornadas. Como só é possível ter uma única instância global dessas configurações, você não precisa incluir a Identity ao chamar Get-CsAccessEdgeConfiguration. No entanto, você pode usar a seguinte sintaxe para recuperar as configurações globais: -Identity global. |
Filter |
Opcional |
Cadeia de caracteres |
Permite a você usar curingas ao especificar as definições de configuração da Borda de Acesso a serem retornadas. Como só é possível ter uma única instância global dessas configurações, há poucos motivos para usar o parâmetro Filter. No entanto, se preferir, você pode usar uma sintaxe semelhante a esta para recuperar as configurações globais: -Identity "g*". |
LocalStore |
Opcional |
Parâmetros de opção |
Obtém os dados de configuração de Borda de Acesso a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma. Get-CsAccessEdgeConfiguration não aceita entrada em pipeline.
Tipos de Retorno
Get-CsAccessEdgeConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting ou do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsAccessEdgeConfiguration
O Exemplo 1 demonstra o uso básico de Get-CsAccessEdgeConfiguration: a chamada do cmdlet sem nenhum parâmetro adicional retorna todos os valores de propriedade para a implementação do Servidor de Borda de Acesso. Observe que não há nenhuma necessidade de incluir os parâmetros Identity ou Filter; isso porque só há um conjunto de dados de configuração do servidor de Borda de Acesso.
-------------------------- Exemplo 2 ------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
O comando anterior retorna apenas estes três valores de propriedade para a configuração do Servidor de Borda de Acesso: AllowAnonymousUsers; AllowFederatedUsers e AllowOutsideUsers. Para isso, o comando usa inicialmente Get-CsAccessEdgeConfiguration para retornar todos os valores de propriedade do Servidor de Borda de Acesso. Em seguida, essas informações são redirecionadas para o cmdlet Select-Object, que só separa as propriedades que começam com o valor da cadeia de caracteres "Allow". Por sua vez, esses são os únicos valores de propriedade exibidos na tela.
-------------------------- Exemplo 3 ------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
O comando mostrado no Exemplo 3 retorna o valor de uma única propriedade de configuração do Servidor de Borda de Acesso: EnablePartnerDiscovery. Para isso, Get-CsAccessEdgeConfiguration é chamado inicialmente para retornar todos os valores de propriedade da configuração do Servidor de Borda de Acesso. A chamada a Get-CsAccessEdgeConfiguration fica entre parênteses; isso garante que Windows PowerShell conclua esse comando antes de fazer qualquer outra coisa. Depois que todos os valores de propriedade retornarem, a "notação de ponto" (nome do objeto seguido de um ponto final e de um nome de propriedade) padrão será usada para exibir o valor de uma única propriedade: EnablePartnerDiscovery.