Set-CsNetworkSite
Tópico modificado em: 2012-03-26
Modifica um site de rede existente que tenha sido definido para controle de admissão de chamadas (CAC) ou Enhanced 9-1-1 (E9-1-1).
Sintaxe
Set-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Os sites de rede são os escritórios ou locais configurados em cada região de uma implantação do CAC ou E9-1-1. Esse cmdlet modifica as definições de um site existente. Isto pode incluir aspectos como a região associada ao site, a descrição do site e o perfil de política de largura de banda associado.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsNetworkSite localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSite"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
O identificador exclusivo do site de rede que se deseja modificar. Como os sites são criados apenas no escopo global, não é necessário especificar o escopo. Em vez disso, é necessário especificar apenas o ID do site de rede. |
Instance |
Opcional |
DisplayNetworkSiteType |
Uma referência a um objeto de site de rede (um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType). Este objeto pode ser recuperado chamando-se o cmdlet Get-CsNetworkSite. |
BWPolicyProfileID |
Opcional |
Cadeia de caracteres |
A Identidade do perfil da política de largura de banda que definirá as limitações a este site. É possível recuperar uma lista de perfis disponíveis, chamando-se o cmdlet Get-CsNetworkBandwidthPolicyProfile. Se for especificado um valor para esse parâmetro, será necessário especificar também o valor do parâmetro NetworkRegionID. |
BypassID |
Opcional |
Cadeia de caracteres |
Um identificador global exclusivo (GUID). Este GUID é usado para mapear sites de rede para definições de desvio de mediação em uma configuração de rede CAC ou E9-1-1. (utilize este valor de BypassID ao chamar New-CsNetworkMediaBypassConfiguration). Se for especificado um valor para esse parâmetro, será necessário especificar também o valor do parâmetro NetworkRegionID. Se não for especificado um valor para este parâmetro, mas NetworkRegionID for especificado, BypassID será gerado automaticamente. Se for explicitamente especificado um valor, ele deverá estar no formato de um GUID (por exemplo: 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Recomendamos que você forneça um valor para NetworkRegionID e permita que o valor BypassID seja gerado automaticamente. Se você digitar um valor, receberá uma solicitação, indagando se não deseja gerar esse valor automaticamente. |
Description |
Opcional |
Cadeia de caracteres |
Uma cadeia de caracteres que descreve o site. Este parâmetro pode ser utilizado para fornecer uma explicação mais descritiva sobre a função ou localização do site, superando o que pode ser expresso apenas pela identidade. |
LocationPolicy |
Opcional |
Cadeia de caracteres |
O nome da política de local associada a este site. A política de local atribui ao site definições do E9-1-1 específicas. Para recuperar uma lista de políticas de local, chame o cmdlet Get-CsLocationPolicy. |
NetworkRegionID |
Opcional |
Cadeia de caracteres |
A identidade da região de rede à qual este site está associado. Este parâmetro deve conter um valor, se se desejar fornecer um BypassID (mediante a geração automática ou manual) ou se a propriedade EnableBandwidthPolicyCheck da configuração de rede for True. É possível recuperar as definições de configuração de rede chamando-se o cmdlet Get-CsNetworkConfiguration. Se este site já tiver um BypassID e não se especificar um valor para o parâmetro BypassID, o BypassID existente será sobrescrito por um BypassID gerado automaticamente. |
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.DisplayNetworkSiteType. Aceita entradas canalizadas dos objetos de site de rede.
Tipos de Retorno
Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
Neste exemplo, o site de rede denominado Vancouver é modificado. O nome do site sendo modificado é especificado como o valor do parâmetro Identity. O site de Vancouver está sendo transferido para uma nova região, que requer que o parâmetro NetworkRegionID seja alterado, neste caso, para a região denominada Canadá. Como um NetworkRegionID foi fornecido, mas nenhum valor foi especificado para BypassID, será gerado automaticamente um valor de BypassID. Qualquer ID de desvio previamente existente será sobrescrito.
-------------------------- Exemplo 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
O Exemplo 2 simplesmente modifica o perfil da política de largura de banda associado ao site de Vancouver. O nome do site é especificado como o valor do parâmetro Identity. Em seguida, especifica-se um valor para o parâmetro BWPolicyProfileID: LowBWLimits. As políticas associadas a esse perfil serão utilizadas neste site.