Get-CsNetworkConfiguration
Tópico modificado em: 2012-03-23
Recupera configurações globais do CAC (controle de admissão de chamadas), do E9-1-1 (Enhanced 9-1-1) e da passagem livre de mídia.
Sintaxe
Get-CsNetworkConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
O objeto de configuração de rede contém todas as definições globais de passagem livre de mídia e de uma configuração completa do CAC em uma implementação do Microsoft Lync Server 2010, incluindo o fato de essa configuração ter sido habilitada ou não. Este cmdlet pode ser usado para recuperar essas configurações e definições. Entretanto, além de EnableBandwidthPolicyCheck e MediaBypassSettings, recomenda-se o uso de cmdlets específicos do tipo do objeto para a recuperação das configurações do CAC. Por exemplo, para recuperar as regiões da rede, geralmente será mais fácil chamar Get-CsNetworkRegion do que chamar Get-CsNetworkConfiguration para então recuperar a propriedade NetworkRegions dessa configuração.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsNetworkConfiguration 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-CsNetworkConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsIdentity |
Este sempre será Global. |
Filter |
Opcional |
Cadeia de caracteres |
Como sempre haverá apenas uma configuração de rede, você não precisará desse parâmetro nesse cmdlet. |
LocalStore |
Opcional |
SwitchParameter |
Recupera a configuração de rede 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.
Tipos de Retorno
Get-CsNetworkConfiguration retorna uma instância do objeto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsNetworkConfiguration
Este exemplo recupera as configurações de rede. Essas configurações são definidas apenas em escopo global, então apenas um item será retornado.
-------------------------- Exemplo 2 --------------------------
(Get-CsNetworkConfiguration).MediaBypassSettings
Há apenas um conjunto de configurações de passagem livre de mídia que se aplicam globalmente. Essas configurações são armazenadas como parte da configuração geral de rede. O comando primeiro recupera essa configuração chamando Get-CsNetworkConfiguration, e em seguida recupera a propriedade MediaBypassSettings da configuração.