Set-CsNetworkSubnet
Tópico modificado em: 2012-03-26
Modifica uma sub-rede existente.
Sintaxe
Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSubnet [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaskBits <Int32>] [-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 modificar o site de rede associado, alterar a descrição da sub-rede ou modificar os bits de máscara da sub-rede.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-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 "Set-CsNetworkSubnet"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
O ID exclusivo da sub-rede que será modificada. Este valor será um endereço IP (como 174.11.12.0) ou uma URL começando com http: ou https:. |
Instance |
Opcional |
SubnetType |
Uma referência a um objeto de sub-rede da rede que será modificado. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType, que pode ser recuperado chamando Get-CsNetworkSubnet. |
Description |
Opcional |
Cadeia de caracteres |
Uma descrição da sub-rede que será modificada. |
MaskBits |
Opcional |
Int32 |
A bitmask a ser aplicada à sub-rede. |
NetworkSiteID |
Opcional |
Cadeia de caracteres |
O ID do site de rede ao qual a sub-rede será aplicada. É 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. |
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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType. Aceita entrada em pipeline de objetos de sub-rede.
Tipos de Retorno
Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
Este exemplo modifica a sub-rede com identidade (o ID de sub-rede) 172.11.15.0. A sub-rede é modificada com um novo valor de MaskBits (25) e um novo NetworkSiteID (Chicago).
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
O Exemplo 2 move todas as sub-redes no site Vancouver para o site Chicago. Para fazer isso, começamos chamando o cmdlet Get-CsNetworkSubnet. Isso irá recuperar uma coleção de todas as sub-redes definidas na implementação do Microsoft Lync Server 2010. Essa coleção de sub-redes é então canalizada para o cmdlet Where-Object. O Where-Object seleciona essa coleção e a restringe apenas às sub-redes com NetworkSiteID igual a (-eq) Vancouver. Agora que a coleção consiste apenas de sub-redes associadas ao site Vancouver, canalizamos a coleção para Set-CsNetworkSubnet. Fornecemos um parâmetro a Set-CsNetworkSubnet: NetworkSiteID. Passando para o parâmetro o valor Chicago, instruímos Set-CsNetworkSubnet a alterar o ID do site de rede de todos os integrantes da coleção para Chicago.