Remove-CsNetworkSubnet
Tópico modificado em: 2012-03-27
Remove uma sub-rede de rede existente.
Sintaxe
Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Cada sub-rede deve ser associada a um site de rede a fim de determinar o local geográfico do host que pertence a essa sub-rede. Utilize este cmdlet para remover uma sub-rede de rede.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsNetworkSubnet localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkSubnet"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsGlobalRelativeIdentity |
O identificador exclusivo da sub-rede que se deseja remover. Este valor será um endereço IP (como 174.11.12.0). |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as 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 dos objetos de sub-rede de rede.
Tipos de Retorno
Este cmdlet não retorna um valor. Ele remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Remove-CsNetworkSubnet -Identity 172.11.15.0
Este exemplo remove todas as sub-redes com a identidade (o ID da sub-rede) 172.11.15.0.
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet
O Exemplo 2 remove todas as sub-redes associadas ao site de Vancouver. Para fazer isso, começamos chamando o cmdlet Get-CsNetworkSubnet. Isto recuperará uma coleção de todas as sub-redes definidas na implantação do Microsoft Lync Server 2010. Essa coleção de sub-redes é então canalizada para o cmdlet Where-Object. Where-Object usa esta coleção e a restringe apenas às sub-redes cujo NetworkSiteID for igual a (-eq) Vancouver. Agora que a coleção consiste apenas em sub-redes associadas ao site de Vancouver, ela será canalizada para Remove-CsNetworkSubnet, que removerá cada item na coleção.