Remove-CsNetworkSite
Tópico modificado em: 2012-03-26
Remove um site de rede que tenha sido definido para o CAC (controle de admissão de chamadas) ou para o E9-1-1 (Enhanced 9-1-1).
Sintaxe
Remove-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Sites de rede são os escritórios ou locais configurados em cada região de uma implementação do CAC ou do E9-1-1. Este cmdlet remove um site da configuração do CAC ou do E9-1-1.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsNetworkSite 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 "Remove-CsNetworkSite"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsGlobalRelativeIdentity |
O identificador único do site de rede que será removido. Os sites são criados apenas em escopo global, não é necessário especificar um escopo. Em vez disso, é preciso especificar apenas a ID do site. |
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.DisplayNetworkSiteType. Aceita entrada em pipeline de objetos de site de rede.
Tipos de Retorno
Este cmdlet não retorna um valor. Remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Remove-CsNetworkSite -Identity Vancouver
Este exemplo remove o site com parâmetro Identity Vancouver da configuração do CAC ou do E9-1-1.
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Remove-CsNetworkSite
O Exemplo 2 remove todos os sites que estejam usando um perfil de diretiva de largura de banda chamado LowBWProfile da configuração do CAC ou do E9-1-1. O exemplo primeiro chama Get-CsNetworkSite para recuperar todos os sites da rede. Essa coleção de sites é canalizada para o cmdlet Where-Object, que restringe a coleção apenas aos sites que tenham BWPolicyProfileID igual a (-eq) LowBWProfile. Essa nova coleção é então encaminhada para Remove-CsNetworkSite para a remoção desses sites.