Compartilhar via


New-CsAVEdgeConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma nova coleção de definições de configuração para computadores que estiverem executando o Serviço de Borda A/V (esses computadores também são conhecidos como servidores de Borda A/V). Os Servidores de Borda A/V permitem que usuários internos compartilhem dados de áudio e vídeo com usuários externos (ou seja, usuários que não tiverem feito logon na sua rede interna).

Sintaxe

New-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Os servidores de Borda A/V permitem que o tráfego de áudio e vídeo atravesse o firewall da organização. Entre outras coisas, isso permite que os usuários usem o Microsoft Lync Server 2010 na Internet e subsequentemente troquem dados de áudio e vídeo com usuários que tiverem feito logon no sistema de dentro do firewall. As definições de configuração do Servidor de Borda podem ser atribuídas no escopo global, de site e de serviço. As definições de configuração de Borda A/V permitem que os administradores gerenciem a duração da validade da autenticação do usuário até a obrigatoriedade de sua renovação e limitem a largura de banda que pode ser usada por um único usuário ou uma única porta.

O cmdlet New-CsAVEdgeConfiguration permite criar novas coleções de definições de configuração de Borda A/V, tanto no escopo de site ou de serviço. Como observado, as definições de Borda A/V também podem ser configuradas no escopo global. No entanto, não é possível criar uma nova coleção no escopo global.

Observe que qualquer site ou serviço determinado pode hospedar, no máximo, uma única coleção de definições de configuração de borda A/V. Se o site de Redmond já hospedar uma coleção de definições de Borda A/V, não será possível criar uma nova coleção com a Identidade site:Redmond.

A menos que seja instruído pela equipe de suporte da Microsoft, é recomendável não alterar as definições de configuração de Borda A/V padrão. Por isso, provavelmente não será necessário criar uma nova coleção de definições para um site ou serviço.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsAVEdgeConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAVEdgeConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração de Borda A/V a ser criada. Para criar uma coleção de definições a ser aplicada no escopo do site, utilize uma sintaxe similar a esta: -Identity site:Redmond (observe que este comando falhará se já tiver sido aplicada uma coleção de definições de configuração de Borda A/V ao site de Redmond). As definições configuradas no escopo de serviço devem usar uma sintaxe semelhante a esta: -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

MaxBandwidthPerPortKB

Opcional

Inteiro

Indica largura máxima de banda (em quilobits por segundo) que pode ser alocada a uma única porta. A largura máxima de banda pode ser definida como sendo qualquer valor inteiro entre 1 e 4.294.967.296 (4.096 gigabits) por segundo. O valor padrão é 3.000.

MaxBandwidthPerUserKB

Opcional

Inteiro

Indica a largura máxima de banda (em quilobits por segundo) que pode ser alocada para cada usuário. A largura máxima de banda pode ser definida como sendo qualquer valor inteiro entre 1 e 4.294.967.296 (4.096 gigabits) por segundo. O valor padrão é 10.000.

MaxTokenLifetime

Opcional

Inteiro

O período máximo de tempo em que um token de autenticação pode ser usado antes que ele expire e deva ser renovado. A vida útil do token é expressa mediante o seguinte formato: Dias.Horas:Minutos:Segundos. Por exemplo: 13 dias devem ser expressos da seguinte maneira, com um ponto (.) seguido do número de dias, e dois pontos (:) usados para separar as horas, minutos e segundos:

13.00:00:00

O valor padrão de oito horas deve ser expresso da seguinte maneira:

08:00:00

A vida útil mínima do token permitida é de um minuto (00:01:00); a máxima é de 180 dias (180.00:00:00).

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

InMemory

Opcional

Parâmetro de opção

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

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. New-CsAVEdgeConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Cria instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Exemplo

-------------------------- Exemplo 1 ------------------------

New-CsAVEdgeConfiguration -Identity site:Redmond -MaxTokenLifetime "04:00:00"

O comando exibido no Exemplo 1 cria uma nova coleção de definições de configuração de Borda A/V para o site de Redmond. Neste exemplo, a propriedade MaxTokenLifetime é definida como quatro horas (04 horas: 00 minutos: 00 segundos).

-------------------------- Exemplo 2 ------------------------

$x = New-CsAVEdgeConfiguration -Identity site:Redmond -InMemory
$x.MaxTokenLifetime = "04:00:00"
Set-CsAVEdgeConfiguration -Instance $x

O Exemplo 2 mostra como se pode criar uma nova coleção de definições de configuração de Borda A/V na memória e, em seguida, transformar essas definições virtuais em uma coleção real de definições de Borda A/V. Para realizar isto, o primeiro comando no exemplo cria uma nova coleção de definições para o site de Redmond; o parâmetro InMemory é adicionado, para garantir que estas definições sejam criadas apenas na memória e não sejam aplicadas imediatamente ao site de Redmond (como estas definições existem apenas na memória, elas devem ser armazenadas em uma variável, nesse caso, denominada $x).

No segundo comando, o valor da propriedade MaxTokenLifetime é definido como quatro horas (04 horas: 00 minutos: 00 segundos). O terceiro comando usa Set-CsAVEdgeConfiguration para aplicar as definições armazenadas em $x ao site Redmond.