Set-CsAVEdgeConfiguration

 

Tópico modificado em: 2012-03-26

Permite modificar as definições de configuração de computadores que estiverem executando o Serviço de Borda A/V (esses computadores também são conhecidos como servidores de Borda A/V). O Servidor de Borda A/V permite a usuários internos compartilhar dados de áudio e vídeo com usuários externos (ou seja, usuários que não tiverem feito logon na rede interna), bem como trocar arquivos e participar de sessões de compartilhamento de área de trabalho.

Sintaxe

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

Set-CsAVEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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. Essas definições de configuração permitem que os administradores realizem ações como gerenciar a duração da validade da autenticação do usuário até a obrigatoriedade de sua renovação e limitar a largura de banda que pode ser usada por um único usuário ou uma única porta.

O cmdlet Set-CsAVEdgeConfiguration constitui uma maneira de modificar as definições de configuração de Borda A/V que estiverem em uso na sua organização. No entanto, a menos que seja instruído pela equipe de suporte da Microsoft, é recomendável que os administradores não alterem as definições de Borda A/V padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-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 "Set-CsAVEdgeConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração de Borda A/V a ser modificada. Para modificar a coleção global, utilize a seguinte sintaxe: -Identity global. Para modificar uma coleção de sites, utilize uma sintaxe similar a esta: -Identity site:Redmond. As definições configuradas no escopo de serviço devem ser referenciadas usando-se uma sintaxe similar a esta: -Identity service:EdgeServer:atl-cs-001.litwareinc.com.

Instance

Opcional

Objeto MediaRelaySettings

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

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 é 3000.

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

TimeSpan

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.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings. Set-CsAVEdgeConfiguration aceita entradas canalizadas dos objetos de definições de retransmissão de mídia.

Tipos de Retorno

Set-CsAVEdgeConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Exemplo

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

Set-CsAVEdgeConfiguration -Identity global -MaxTokenLifetime "04:00:00"

No Exemplo 1, o comando modifica a propriedade MaxTokenLifetime das definições globais de configuração de Borda A/V. Neste exemplo, a vida útil máxima do token é definida como quatro horas (04 horas: 00 minutos: 00 segundos).