Compartilhar via

  • Artigo

New-CsNetworkSubnet

 

Tópico modificado em: 2012-03-27

Cria uma nova sub-rede.

Sintaxe

New-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> -MaskBits <Int32> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkSubnet -MaskBits <Int32> -SubnetID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Cada sub-rede deve ser associada a um site de rede para que seja determinada a localização geográfica do host que pertence a essa sub-rede. Use este cmdlet para criar uma nova sub-rede, e ao mesmo tempo (opcionalmente) atribuí-la a um site de rede.

Na maioria das implementações do Microsoft Lync Server 2010 nas quais o CAC (controle de admissão de chamadas) foi implementado, há um grande número de sub-redes. Por esse motivo, geralmente é melhor chamar New-CsNetworkSubnet junto com o cmdlet Import-CSV do Windows PowerShell. Ao usar esses cmdlets juntos, é possível ler configurações de sub-rede a partir de um arquivo de valores separados por vírgula (CSV) e criar várias sub-redes de uma só vez. Para obter informações mais detalhadas, consulte a seção de exemplos deste cmdlet.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsNetworkSubnet localmente: 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 "New-CsNetworkSubnet"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

A ID exclusiva da sub-rede que está sendo criada. Ela precisa ser um endereço IP (como 174.11.12.0), e precisa ser o primeiro endereço no intervalo de endereços IP definido pela sub-rede.

MaskBits

Obrigatório

Int32

A bitmask a ser aplicada à sub-rede que está sendo criada.

Valores válidos: De 1 a 32

SubnetID

Obrigatório

Cadeia de caracteres

O mesmo valor que Identity. Você deve especificar uma Identity ou uma SubnetID, mas não pode especificar ambas. O valor fornecido para uma será automaticamente aplicado à outra.

Description

Opcional

Cadeia de caracteres

Uma descrição da sub-rede que está sendo criada.

NetworkSiteID

Opcional

Cadeia de caracteres

A ID do site ao qual a sub-rede pertence. É possível recuperar IDs de sites da sua implementação chamando o cmdlet Get-CsNetworkSite.

Force

Opcional

SwitchParameter

Suprime eventuais avisos de confirmação que seriam exibidos antes da realização das alterações.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.

Exemplo

-------------------------- Exemplo 1 --------------------------

New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver

Este exemplo demonstra como criar um novo objeto de sub-rede que representa a sub-rede 172.11.15.0/24. A identidade da sub-rede é definida como 172.11.15.0. Esse valor será atribuído automaticamente como SubnetID. Uma sub-rede precisa ter bits de máscara definidos. Isso é feito fornecendo-se um valor — no caso, 24 — ao parâmetro MaskBits. Por fim, a ID do site Vancouver é passada para o parâmetro NetworkSiteID para associação dessa sub-rede ao site.

-------------------------- Exemplo 2 --------------------------

Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}

O Exemplo 2 lê um arquivo CSV para criar uma série de sub-redes. O arquivo CSV do exemplo é parecido com isto:

Identity, Mask, SiteID

172.11.12.0, 24, Redmond

172.11.13.0, 24, Chicago

172.11.14.0, 25, Vancouver

172.11.15.0, 31, Paris

...

O exemplo começa chamando o cmdlet Import-CSV, passando para ele o caminho para um arquivo CSV. O cmdlet lê o conteúdo desse arquivo para a memória. Esse conteúdo é canalizado para a função foreach. A função foreach faz a iteração pelo conteúdo, uma linha de cada vez. Como se pode ver no arquivo de exemplo, a primeira linha é uma lista de títulos que definem o resto do conteúdo; a função foreach usa esses títulos para acessar os valores separados por vírgula pelo nome.

Dentro da declaração foreach, o cmdlet New-CsNetworkSubnet é chamado. Conforme o foreach faz a iteração por cada linha de conteúdo do arquivo, essa linha é passada na forma de valores para os parâmetros do New-CsNetworkSubnet. Por exemplo, na primeira passagem pela declaração foreach, New-CsNetworkSubnet cria uma sub-rede com a identidade 172.11.12.0: esse é o valor na posição Identity (identidade) na primeira linha de valores separados por vírgula. (O $_ indica o valor atual no loop foreach.) O valor de Mask (24) é passado para o parâmetro MaskBits, e o valor de SiteID (Redmond) do arquivo é passado para o parâmetro NetworkSiteID.

Esse processo continua até que todas as linhas do arquivo tenham sido lidas, e seus valores usados para criar novas sub-redes.