Set-CsExternalAccessPolicy

Sintaxe

Set-CsExternalAccessPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableFederationAccess <$true | $false>] [-EnableOutsideAccess <$true | $false>] [-EnablePublicCloudAccess <$true | $false>] [-EnablePublicCloudAudioVideoAccess <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsExternalAccessPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableFederationAccess <$true | $false>] [-EnableOutsideAccess <$true | $false>] [-EnablePublicCloudAccess <$true | $false>] [-EnablePublicCloudAudioVideoAccess <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Quando se instala o Lync Server 2010, os usuários podem apenas trocar mensagens instantâneas e informações de presença entre si: por padrão, eles podem se comunicar apenas com outras pessoas que possuem contas SIP no seu Serviços de Domínio Active Directory (AD DS). Além disso, os usuários não podem acessar Lync Server 2010 na Internet; em vez disso, eles devem estar logados na rede interna para poderem efetuar o logon no Lync Server 2010.

Isto pode ser suficiente para atender às suas necessidades de comunicação. Se não atender às suas necessidades, é possível utilizar políticas de acesso externo para ampliar a capacidade dos usuários se comunicarem e colaborarem entre si. As políticas de acesso externo podem conceder (ou revogar) aos usuários quaisquer (ou todas) as capacidades dentre as seguintes:

1. comunicar-se com pessoas que tenham contas SIP em uma organização federada. Observe que a habilitação apenas da federação não fornecerá essa capacidade aos usuários. Em vez disso, deve-se habilitar a federação e atribuir aos usuários uma política de acesso externo que lhes dê o direito de se comunicar com usuários federados.

2. comunicar-se com pessoas que tiverem contas SIP em um serviço público de mensagens instantâneas, como o MSN.

3. acessar o Lync Server 2010 na Internet, sem ter de efetuar o logon inicial na rede interna. Isto permite aos usuários utilizar o Microsoft Lync 2010 e efetuar o logon no Lync Server 2010 em um cybercafé ou outro local remoto.

Depois que tiver se criado uma política de acesso externo, será possível usar o cmdlet Set-CsExternalAccessPolicy para alterar os valores da propriedade dessa política. Por exemplo, por padrão, a política global não permite que os usuários se comuniquem com pessoas que possuam contas em uma organização federada. Se você quiser conceder essa capacidade a todos os usuários, chame Set-CsExternalAccessPolicy e defina o valor da propriedade EnableFederationAccess da política global como True.

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

Parâmetros

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.ExternalAccess.ExternalAccessPolicy. Set-CsExternalAccessPolicy aceita a entrada canalizada do objeto de política de acesso externo.

Tipos de Retorno

Set-CsExternalAccessPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ExternalAccess.ExternalAccessPolicy.

Exemplo

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

Set-CsExternalAccessPolicy -Identity RedmondExternalAccessPolicy -EnableFederationAccess $True

O comando exibido no Exemplo 1 modifica a política de acesso externo por usuário cuja Identidade for RedmondExternalAccessPolicy. Nesse exemplo, o comando altera para True o valor da propriedade EnableFederationAccess.

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

Get-CsExternalAccessPolicy | Set-CsExternalAccessPolicy -EnableFederationAccess $True

No Exemplo 2, o acesso à federação é habilitado para todas as políticas de acesso externo configuradas para uso na organização. Para fazer isso, o comando chama primeiramente Get-CsExternalAccessPolicy sem quaisquer parâmetros. Isto retorna uma coleção de todas as políticas externas configuradas para uso. Essa coleção será então canalizada para Set-CsExternalAccessPolicy, que alterará o valor da propriedade EnableFederationAccess de cada política na coleção.

-------------------------- Exemplo 3 ------------------------

Get-CsExternalAccessPolicy -Filter tag:* | Set-CsExternalAccessPolicy -EnableFederationAccess $True

O exemplo anterior permite o acesso à federação para todas as políticas de acesso externo que tiverem sido configuradas no escopo por usuário. Para realizar essa tarefa, a primeira coisa que o comando faz é usar Get-CsExternalAcessPolicy e o parâmetro Filter, para retornar uma coleção de todas as políticas que tiverem sido configuradas no escopo por usuário. (o valor de filtro "tag:*" limita os dados retornados a políticas que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "tag:". Qualquer política com uma Identidade que comece com "tag:" que tenha sido configurada no escopo por usuário). A coleção filtrada será então canalizada para Set-CsExternalAccessPolicy, que modificará a propriedade EnableFederationAccess de cada política na coleção.

-------------------------- Exemplo 4 ------------------------

Get-CsExternalAccessPolicy | Where-Object {$_.EnablePublicCloudAccess -eq $True} | Set-CsExternalAccessPolicy -EnableFederationAccess $True

No Exemplo 4, o acesso à federação é habilitado para todas as políticas de acesso externo que permitirem o acesso público na nuvem. Para fazer isso, o comando usa primeiramente Get-CsExternalAccessPolicy, para retornar uma coleção de todas as políticas de acesso externo configuradas para uso na organização. Esta coleção será conectada ao cmdlet Where-Object, que selecionará apenas as políticas cuja propriedade EnablePublicCloudAccess for igual a True. Essa coleção filtrada será então canalizada para Set-CsExternalAccessPolicy, que selecionará cada política e definirá a propriedade EnableFederationAccess como True. O resultado: todas as políticas de acesso externo que permitirem o acesso público na nuvem também permitirão o acesso à federação.

Consulte Também

Outros Recursos

Get-CsExternalAccessPolicy
Grant-CsExternalAccessPolicy
New-CsExternalAccessPolicy
Remove-CsExternalAccessPolicy