New-CsSimpleUrlConfiguration
Tópico modificado em: 2012-10-17
Cria uma nova coleção de configurações de URLs simples. As URL simples facilitam a participação dos usuários em reuniões e conferências. Elas também facilitam a entrada de Administradores no Painel de Controle do Microsoft Lync Server 2010.
Sintaxe
New-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
No Microsoft Office Communications Server 2007 R2, as reuniões tinham URLs com a seguinte aparência:
No entanto, esses URLs não são especialmente intuitivos e não são fáceis de transmitir para outras pessoas. Os URLs simples introduzidos no Lync Server 2010 ajudam a resolver esses problemas, fornecendo aos usuários URLs cuja aparência se assemelha mais a:
https://meet.litwareinc.com/kenmyer/071200
Os URLs simples constituem um aprimoramento em relação aos URLs utilizados no Office Communications Server. Entretanto, os URL simples não são criados automaticamente. Ou seja, deve-se configurá-los manualmente. Além disso, também é necessário realizar ações como criar os registros do Sistema de nomes de domínio (DNS) de cada URL, configurar regras de proxy reverso para acesso externo, adicionar URLs simples aos certificados do Servidor Front-End, e assim por diante.
O Lync Server permite a criação de três diferentes URLs simples:
Reunião – utilizado nas reuniões. Cada domínio SIP deve ter pelo menos um URL de Reunião.
Admin – utilizado para apontar os administradores para o Painel de Controle do Lync Server 2010.
Dialin – utilizado para indicar a página da web referente à conferência discada.
Os URLs simples são armazenados nas coleções de configuração de URL simples. Ao se instalar o Lync Server, cria-se uma coleção global. Também é possível criar coleções personalizadas no escopo de site. Isso possibilita utilizar URL simples diferentes em todos os sites.
As coleções de configurações de URLs simples são criadas utilizando-se o cmdlet New-CsSimpleUrlConfiguration. É possível utilizar outros cmdlets (como New-CsSimpleUrl e Set-CsSimpleUrlConfiguration) para preencher essas coleções com URLs simples. Depois de atualizar uma coleção de URLs simples, deve-se executar o cmdlet Enable-CsComputer.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsSimpleUrlConfiguration 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 "New-CsSimpleUrlConfiguration"}
Parâmetros
Parâmetro | Obrigatório | Tipo | Descrição |
---|---|---|---|
Identity |
Obrigatório |
Identidade de Xds |
Identificador exclusivo da nova coleção de configuração de URL simples. Como as novas coleções só podem ser criadas no escopo de site, a Identidade deve ser o prefixo "site:" seguido do nome do site. Por exemplo, esta sintaxe cria uma nova coleção para o site Redmond: -Identity "site:Redmond". |
SimpleUrl |
Opcional |
Modificador de Lista PS |
Os URLs simples que foram configurados para essa coleção. Esses URLs devem ser criados utilizando-se os cmdlets New-SimpleUrl e New-SimpleUrlEntry. |
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. |
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. |
Tenant |
Opcional |
Guid |
Este parâmetro não é usado com a versão local do Lync Server. |
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.
Tipos de Retorno
New-CsSimpleUrlConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.
Exemplo
-------------------------- Exemplo 1 ------------------------
New-CsSimpleUrlConfiguration -Identity "site:Redmond"
O comando apresentado no Exemplo 1 cria uma nova coleção de URLs simples para o site de Redmond. Como não há outros parâmetros além de Identity incluídos neste comando, a nova coleção não terá nenhum URL simples. Este comando falhará se o site de Redmond já hospedar uma coleção de URLs simples.
-------------------------- Exemplo 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrlEntry $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2
New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}
O exemplo anterior mostra como é possível criar uma nova coleção de URLs simples que incluírem dois URLs simples (um para o gerenciamento de reuniões e o outro para conferências discadas). Para isso, o primeiro comando no exemplo usa New-CsSimpleUrlEntry para criar uma entrada de URL que aponte para https://dialin.litwareinc.com; esta entrada de URL será armazenada em uma variável denominada $urlEntry. O segundo comando cria outra entrada de URL, que aponta para https://meet.fabrikam.com.
Em seguida, utiliza-se o cmdlet New-CsSimpleUrl para criar uma instância somente em memória de um URL simples. Neste exemplo, define-se o componente URL como dialin; configura-se o domínio como um asterisco (*), define-se a propriedade ActiveUrl como https://dialin.fabrikam.com e define-se a propriedade SimpleUrl como $urlEntry. (a variável $urlEntry representa a entrada de URL criada no primeiro comando). Utiliza-se um comando similar para criar o URL simples de meet.fabrikam.com.
Depois que o URL tiver sido criado (e armazenado nas referências de objeto $simpleUrl e $simpleUrl2), o comando final no exemplo criará uma nova coleção de URL simples para o site de Redmond, adicionando os dois novos URLs somente em memória a essa coleção. O novo URL é adicionado à coleção utilizando-se o cmdlet New-CsSimpleUrlConfiguration, o parâmetro SimpleUrl e o valor de parâmetro @{Add=$simpleUrl, $simpleUrl2}. Esta sintaxe adiciona os URLs armazenados nas referências de objeto $simpleUrl e $simpleUrl2 à propriedade SimpleUrl.
Consulte Também
Outros Recursos
Get-CsSimpleUrlConfiguration
New-CsSimpleUrl
New-CsSimpleUrlEntry
Remove-CsSimpleUrlConfiguration
Set-CsSimpleUrlConfiguration