Get-CsNetworkInterface
Tópico modificado em: 2012-03-23
Retorna informações sobre as interfaces de rede em uso em computadores executando os serviços do Microsoft Lync Server 2010 ou as funções de servidor.
Sintaxe
Get-CsNetworkInterface [-Identity <NetworkInterfaceIdentity>] [-ComputerFqdn <Fqdn>]
Get-CsNetworkInterface [-ComputerFqdn <Fqdn>] [-Filter <String>]
Descrição Detalhada
Para que as informações sejam transmitidas de um computador para outro, os computadores precisam de interfaces de rede: conexões entre um computador e a rede. Os computadores executando os serviços do Lync Server 2010 ou funções de servidor precisam ter ao menos uma interface de rede ou não poderão se comunicar com outros computadores. No entanto, esses computadores podem ter várias interfaces de rede; por exemplo, um Servidor de Borda pode ter uma interface para conexão com a rede interna e outra para conexão com a Internet. O cmdlet Get-CsNetworkInterface oferece uma forma de os administradores retornarem informações sobre as interfaces de rede atualmente em uso em computadores executando os serviços do Lync Server ou funções de servidor.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsNetworkInterface 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-CsNetworkInterface"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade da interface de rede |
Identificador exclusivo para a interface de rede a ser retornada. A identidade de uma interface de rede contém três partes: O FQDN (nome de domínio totalmente qualificado) do próprio computador (por exemplo, atl-cs-001.litwareinc.com). O "lado" da interface de rede (Primary; Internal; External; rede telefônica pública comutada). O lado indica o tipo de tráfego para o qual a porta é usada. O número da interface de rede para esse lado em particular. Por exemplo: -Identity "atl-cs-001.litwareinc.com/Primary/1". Os parâmetros Identity, ComputerFqdn e Filter precisam ser usados separadamente; por exemplo, não é possível executar um comando que use ambos os parâmetros ComputerFqdn e Identity. Além disso, não é possível usar caracteres curinga ao especificar a identidade. Para usar caracteres curinga, use o parâmetro Filter. Se nenhum dos parâmetros Identity, ComputerFqdn ou Filter forem usados, então Get-CsNetworkInterface retornará informações sobre todas as interfaces de rede atualmente em uso em seus computadores executando um serviço do Lync Server ou funções de servidor. |
Filter |
Opcional |
Cadeia de caracteres |
Permite que você use caracteres curinga ao especificar a(s) interface(s) de rede a ser(em) retornada(s). Por exemplo, esta sintaxe retornará informações sobre a interface de rede principal usada em todos os seus computadores executando um serviço do Lync Server ou função de servidor: -Filter "*/Primary/*". |
ComputerFqdn |
Opcional |
Cadeia de caracteres |
FQDN do computador para o qual a informação de interface de rede deverá ser retornada. Por exemplo, para retornar informação de interface de rede para o computador atl-cs-001.litwareinc.com (e somente para esse computador), use esta sintaxe: -ComputerFqdn atl-cs-001.litwareinc.com. |
Tipos de Entrada
Nenhuma. Get-CsNetworkInterface não aceita entrada em pipeline.
Tipos de Retorno
Get-CsNetworkInterface retorna uma instância do objeto Microsoft.Rtc.Management.Xds.DisplayNetworkInterface.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsNetworkInterface
O comando anterior retorna informações para todas as interfaces de rede configuradas para uso na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsNetworkInterface -Identity atl-cs-001.litwareinc.com/Primary/1
O comando mostrado no Exemplo 2 retorna informações sobre uma única interface de rede: a interface que possui identidade igual a atl-cs-001.litwareinc.com.com/Primary/1.
-------------------------- Exemplo 3 ------------------------
Get-CsNetworkInterface -Filter "*.litwareinc.com*"
No Exemplo 3, informações são retornadas para todas as interfaces de rede no domínio litwareinc.com. Para fazer isso, o parâmetro Filter foi incluído, com valor de filtro igual a "*.litwareinc.com*". Esse valor de filtro limita os dados retornados a interfaces que possuam identidade incluindo a cadeia de caracteres "litwareinc.com".
-------------------------- Exemplo 4 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -eq "192.168.0.240"}
O Exemplo 4 retorna informações sobre todas as interfaces de rede configuradas para o endereço IP 192.168.0.240. Para fazer isso, o comando chama primeiro Get-CsNetworkInterface sem nenhum parâmetro; isso retornará uma coleção de todas as interfaces de rede configuradas para uso na organização. Essa coleção é então canalizada para o cmdlet Where-Object, que seleciona somente aquelas interfaces cuja propriedade IPAddress seja igual a 192.168.0.240.
-------------------------- Exemplo 5 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -like "192.168.0.*"}
O comando mostrado no Exemplo 5 é uma variação do comando mostrado no Exemplo 4; neste caso, as informações são retornadas para todas as interfaces de rede configuradas para a sub-rede "192.168.0.*". Para fazer isso, é preciso recuperar uma coleção de todas as interfaces de rede, canalizar essa coleção para o Where-Object e então selecionar somente aquelas interfaces cujo endereço IP comece pela cadeia de caracteres "192.168.0.".
-------------------------- Exemplo 6 ------------------------
Get-CsNetworkInterface | Where-Object {$_.Interface -eq "External"}
O comando anterior retorna todas as interfaces de rede que foram configuradas para acesso externo. Para fazer isso, é preciso primeiro chamar Get-CsNetworkInterface sem nenhum parâmetro; isso retornará uma coleção de todas as interfaces de rede atualmente em uso. Essa coleção é então canalizada para o cmdlet Where-Object, que seleciona somente aqueles itens cuja propriedade Interface seja igual a External.