Compartilhar via

  • Artigo

New-CsHostingProvider

 

Tópico modificado em: 2012-03-26

Cria um novo provedor de hospedagem para uso na organização. Um provedor de hospedagem é uma organização privada de terceiros que fornece mensagens instantâneas, presença e serviços relacionados a um domínio com o qual se deseja estabelecer federação. Os provedores de hospedagem, como Microsoft Lync Online 2010, diferem dos públicos (como o Yahoo!, MSN e AOL) por seus serviços não serem oferecidos ao público em geral.

Sintaxe

New-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

New-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -EnabledSharedAddressSpace <$true | $false> -HostsOCSUsers <$true | $false> -ProxyFqdn <String> [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A federação é uma forma segundo a qual duas organizações podem definir uma relação de confiança que facilita a comunicação entre si. Quando se estabelece uma federação, os usuários nas duas organizações podem enviar mensagens instantâneas entre si, se registrar para notificação de presença e se comunicar entre si utilizando aplicativos SIP como o Lync 2010. O Microsoft Lync Server 2010 permite três tipos de federação: 1) federação direta entre uma organização e a outra, 2) federação entre uma organização e um provedor público e 3) federação entre uma organização e um provedor de hospedagem de terceiros.

Um provedor de hospedagem é uma organização que presta serviços de comunicação SIP para outras organizações. Por exemplo: Fabrikam, Inc. pode hospedar usuários da Contoso, da Northwind Traders e Wingtip Toys. Quando se estabelece uma relação de federação com um provedor de hospedagem, a federação é efetivamente estabelecida em qualquer organização hospedada por esse provedor. Por exemplo: se você estabelecer uma federação com a Fabrikam, os usuários poderão trocar mensagens instantâneas e informação de presença com os usuários da Contoso, Northwind Traders e Wingtip Toys.

Os provedores de hospedagem são também utilizados em situações onde haja divisão de domínios. Em um situação de divisão de domínios, alguns dos usuários do Lync Server 2010 têm contas hospedadas locais (isto é, hospedadas na implementação local do Lync Server). As contas de outros usuários serão mantidas remotamente pelo provedor de hospedagem de terceiros. A federação com o provedor de hospedagem permite aos usuários locais e remotos se comunicarem entre si.

Para estabelecer uma federação com um provedor de hospedagem de terceiros, é preciso criar e habilitar um novo provedor de hospedagem (além disso, o provedor de terceiros precisará criar um relacionamento de federação com você). O cmdlet New-CsHostingProvider permite definir três tipos de relacionamentos com o provedor de hospedagem:

Federação direta com o provedor de hospedagem. Para criar este tipo de relacionamento, devem-se incluir os três parâmetros obrigatórios: Identity, ProxyFqdn e Enabled.

Domínio dividido, com os serviços do Lync Server hospedados. Para criar este tipo de relacionamento, é necessário incluir os três parâmetros obrigatórios. Além disso, as duas propriedades (EnabledSharedAddressSpace e HostsOCSUsers) devem ser definidas como True.

Domínio dividido, com os serviços diferentes do Lync Server (como Microsoft Exchange) hospedados. Para criar este tipo de relacionamento, é necessário incluir os três parâmetros obrigatórios. Além disso, deve-se definir EnabledSharedAddressSpace como True e HostsOCSUsers como False.

Quando se cria um novo provedor de hospedagem, a identidade e o nome de domínio totalmente qualificado (FQDN) do proxy desse provedor devem ser exclusivos: não é possível que haja dois provedores de hospedagem (ou mesmo um provedor de hospedagem e um provedor público) compartilhando uma identidade e/ou um FQDN proxy.

Observe também que não é possível estabelecer uma federação com um provedor de hospedagem se seu Servidores de Borda estiver configurado para utilizar o roteamento padrão, em vez do roteamento de servidor DNS.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Cadeia de caracteres

Identificador exclusivo do provedor de hospedagem a ser criado. A Identidade é um valor de cadeia de caracteres; a Identidade deve ser o FQDN do provedor de hospedagem (por exemplo: fabrikam.com) ou talvez o nome da empresa que oferece os serviços (Fabrikam, Inc.).

As identidades dos provedores de hospedagem devem ser exclusivas. O comando falhará caso se tente criar um novo provedor de hospedagem com a mesma identidade de um provedor existente.

Enabled

Obrigatório

Booleano

Indica se a conexão de rede entre o seu domínio e o provedor de hospedagem está habilitada. Não será possível trocar mensagens entre as duas organizações enquanto este valor não estiver definido como True. O valor padrão é False.

ProxyFqdn

Obrigatório

FQNDN

O nome de domínio totalmente qualificado do servidor proxy usado pelo provedor de hospedagem. Observe que este valor não pode ser modificado. Se o provedor de hospedagem alterar posteriormente o servidor proxy ou se você cometer um erro ao especificar pela primeira vez o FQDN do proxy, será necessário excluir e depois recriar a entrada para esse provedor.

AutoDiscoverUrl

Opcional

String

URL for the autodiscover service used by a hosting provider that hosts Lync Server accounts. The autodiscover service enables client applications such as Microsoft Lync Mobile to determine how to access resources such as a user’s home pool.

EnabledSharedAddressSpace

Opcional

Booleano

Se estiver definido como True, indica que o provedor de hospedagem está sendo utilizado em uma situação de divisão de domínios. O valor padrão é False.

HostsOCSUsers

Opcional

Booleano

Se estiver definido como True, indica que o provedor de hospedagem é usado para hospedar contas do Lync Server. Se estiver definido como False, indica que o provedor hospeda outros tipos de contas, como contas do Microsoft Exchange. O valor padrão é False.

IsLocal

Opcional

Booleano

Se for definido como True, indica que o servidor proxy utilizado pelo provedor de hospedagem está contido na sua topologia do Lync Server. O valor padrão é False.

VerificationLevel

Optional

Cadeia de caracteres

Indica o nível de verificação permitido de mensagens enviadas de e para o provedor de hospedagem. VerificationLevel deve ser definido com um dos seguintes valores:

AlwaysVerifiable. Indica que todas as mensagens enviadas pelo provedor de hospedagem serão consideradas verificáveis. Isso significa que nenhuma mensagem do provedor de hospedagem será rejeitada.

AlwaysUnverifiable. Indica que todas as mensagens enviadas pelo provedor de hospedagem serão consideradas não-verificáveis. Como resultado, as mensagens serão passadas somente se o usuário no provedor de hospedagem estiver na sua lista de contatos.

UseSourceVerification. Depende do nível de verificação incluído nas mensagens enviadas pelo provedor de hospedagem. Se este nível não for especificado, a mensagem será rejeitada como sendo não-verificável.

O valor padrão é AlwayVerifiable.

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-CsHostingProvider não aceita a entrada canalizada.

Tipos de Retorno

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

Exemplo

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

New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

No Exemplo 1, cria-se um novo provedor de hospedagem com a identidade Fabrikam.com. Além de especificar a identidade, o comando também inclui os dois outros parâmetros obrigatórios: ProxyFqdn (que especifica o servidor proxy utilizado por Fabrikam.com) e Enabled, que indica se o novo provedor de hospedagem está habilitado ou não para uso. Caso se esqueça algum dos parâmetros obrigatórios, New-CsHostingProvider solicitará a digitação desses valores antes de continuar.

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

New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -HostsOCSUsers $True -EnabledSharedAddressSpace $True

O Exemplo 2 demonstra como se pode criar um novo provedor de hospedagem para utilização em uma situação de divisão de domínios. (a divisão de domínio significa que algumas das contas do Lync Server serão mantidas localmente, enquanto outras serão mantidas por um provedor de hospedagem.) Para criar este tipo de provedor de hospedagem deve-se incluir os três parâmetros obrigatórios (Identity, ProxyFqdn e Enabled). Além disso, deve-se incluir e definir como True os parâmetros HostsOCSUsers e EnabledSharedAddressSpace. Para criar um provedor de domínios divididos que hospede serviços diferentes do Lync Server (como o Microsoft Exchange), deve-se incluir esses mesmos parâmetros, mas definir HostsOCSUsers como False.