New-CsNetworkSite
Tópico modificado em: 2012-03-27
Cria um novo local de rede para uso com o controle de admissão de chamadas (CAC) ou Enhanced 9-1-1 (E9-1-1).
Sintaxe
New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSite -NetworkRegionID <String> -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <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. Este cmdlet cria um novo site e, opcionalmente, o associa a uma região. Por exemplo, uma região de rede na América do Norte pode ser associada a sites de redes como Chicago, Redmond e Vancouver. Um site de rede CAC deve ser criado para cada site na organização, mesmo se esse site não tiver limitações de largura de banda.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsNetworkSite 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 "New-CsNetworkSite"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsGlobalRelativeIdentity |
Um identificador exclusivo do site de rede recém-criado. Os sites são criados apenas no escopo global, de forma que não é necessário que esse identificador especifique um escopo. Em vez disso, ele contém uma cadeia de caracteres que é exclusiva entre todos os sites de rede na implantação do Microsoft Lync Server 2010. |
NetworkRegionID |
Obrigatório |
Cadeia de caracteres |
A identidade da região de rede à qual este site está associado. Este parâmetro deve conter um valor, caso se deseje 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. |
NetworkSiteID |
Obrigatório |
Cadeia de caracteres |
Este valor é o mesmo que a identidade. Não é possível especificar uma Identity e uma NetworkSiteID; o valor digitado para uma será automaticamente utilizado para ambas. |
BWPolicyProfileID |
Opcional |
Cadeia de caracteres |
A Identidade do perfil da política de largura de banda que definirá as limitações de largura de banda deste 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 um valor para o parâmetro NetworkRegionID. |
BypassID |
Opcional |
Cadeia de caracteres |
GUID (identificador global exclusivo) 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 não for especificado um valor para este parâmetro, será gerado automaticamente um valor, mas somente se for fornecido um valor para o parâmetro NetworkRegionID. Se o parâmetro NetworkRegionID não for fornecido, nenhum BypassID será gerado. Também não é possível fornecer explicitamente um valor para o parâmetro BypassID sem também fornecer um valor para o parâmetro NetworkRegionID. Se for explicitamente especificado um valor, ele deve estar no formato de um GUID (por exemplo: 3b24a047-dce6-48b2-9f20-9fbff17ed62a). Recomenda-se a geração automática. 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. É possível recuperar uma lista de políticas de local, chamando-se o cmdlet Get-CsLocationPolicy. |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as 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.DisplayNetworkSiteType.
Exemplo
-------------------------- Exemplo 1 --------------------------
New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica
Neste exemplo, o site de rede denominado Vancouver é criado. O nome do site é especificado como o valor do parâmetro Identity. Também se especifica o valor do parâmetro NetworkRegionID, que associa o site à região (NorthAmerica, neste exemplo). Um valor de BypassID será gerado automaticamente. A definição manual do valor de BypassID não é recomendada.
Observe que o comando neste exemplo não incluiu o parâmetro BWPolicyProfileID. A menos (ou até) que um valor seja adicionado mais tarde a esse site utilizando-se Set-CsNetworkSite, este site não terá limitações de largura de banda para as conexões de mídia.
-------------------------- Exemplo 2 --------------------------
New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA -BWPolicyProfileID LowBWLimits
No Exemplo 2, cria-se um novo site de rede denominado Paris. O nome do site é especificado como o valor do parâmetro Identity. Como no Exemplo 1, também se especificou um valor para NetworkRegionID (desta vez, a região EMEA). Mais uma vez, segue-se o caminho recomendado, permitindo ao cmdlet gerar BypassID. Diferentemente do Exemplo 1, este exemplo também especifica um valor para o parâmetro BWPolicyProfileID: LowBWLimits. As políticas associadas a esse perfil serão utilizadas neste site.