Compartilhar via

  • Artigo

Get-CsUserServicesConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração de Serviços de usuários em uso na organização. Os Serviços de usuários contribuem para manter as informações de presença e gerenciar as conferências.

Sintaxe

Get-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUserServicesConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

O Microsoft Lync Server 2010 se baseia nos Serviços de usuários para contribuir para manter informações de presença de usuários e gerenciar reuniões e conferências. Por sua vez, os cmdlets CsUserServicesConfiguration são usados para administrar as definições dos Serviços de usuários em escopo global, de site e de serviço. (observe que o único serviço que pode hospedar as definições de configuração dos Serviços de usuários é o próprio Serviço de usuários.) Essas definições ajudam a determinar certos aspectos, como o número de contatos que um usuário pode ter, o número de reuniões que um usuário pode ter agendado por vez e o período de atividade de uma determinada reunião.

O cmdlet Get-CsUserServicesConfiguration permite aos administradores recuperar as informações sobre quaisquer (ou todas) as definições de configuração dos Serviços de usuários em uso.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsUserServicesConfiguration localmente: RTCUniversalUserAdmins, 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 no prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração dos Serviços de usuários a serem retornadas. Para retornar as definições globais, utilize esta sintaxe: -Identity global. Para retornar as definições configuradas no escopo do site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Para retornar definições no nível de serviço, utilize uma sintaxe como esta: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Se este parâmetro for omitido, Get-CsUserServicesConfiguration retornará todas as definições de configuração dos Serviços de usuários que estiverem em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao recuperar uma ou mais coleções de definições de configuração dos Serviços de usuários. Por exemplo, para retornar todas as definições configuradas no escopo do site, utilize esta sintaxe: -Filter "site:*" Para retornar todas as definições configuradas no escopo do serviço, utilize esta sintaxe: -Filter "service:*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da configuração dos Serviços de usuários da réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsUserServicesConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsUserServicesConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Exemplo

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

Get-CsUserServicesConfiguration

O comando apresentado no Exemplo 1 retorna uma coleção de todas as definições de configuração dos Serviços de usuários em uso na organização. Isto é feito chamando-se Get-CsUserServicesConfiguration sem nenhum parâmetro adicional.

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

Get-CsUserServicesConfiguration -Identity site:Redmond

No Exemplo 2, é retornada uma única coleção de definições de configuração dos Serviços de usuários: a coleção com a identidade site:Redmond. Como as identidades devem ser exclusivas, este comando nunca retornará mais do que um item.

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

Get-CsUserServicesConfiguration -Filter "service:*"

O Exemplo 3 retorna uma coleção de todas as definições de configuração dos Serviços de usuários que tiverem sido aplicadas no escopo de serviço. Isto é feito chamando-se Get-CsUserServicesConfiguration, juntamente com o parâmetro -Filter; o valor de filtro "service:*" limita os dados retornados às definições cuja identidade for iniciada pelos caracteres "service:". Por definição, estas definições são configuradas no escopo de serviço.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250}

O comando anterior retorna todas as definições de configuração dos Serviços de usuários que permitirem aos usuários ter mais de 250 contatos. Para fazer isso, o comando chama primeiramente Get-CsUserServicesConfiguration sem quaisquer parâmetros adicionais, retornando uma coleção de todas as definições de configuração dos Serviços de usuários que estiverem em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade MaxContacts for maior do que 250.

-------------------------- Exemplo 5 --------------------------

Get-CsUserServicesConfiguration | Where-Object {$_.AnonymousUserGracePeriod -gt "00:10:00"}

No Exemplo 5, relatam-se as informações relativas às definições de configuração dos Serviços de usuários cujo período de graça de usuário anônimo for maior do que dez minutos. Para realizar essa tarefa, o comando primeiramente chama Get-CsUserServicesConfiguration sem qualquer parâmetro adicional, que retornará uma coleção de todas as definições de configuração dos Serviços de usuários que estiverem em uso na organização. A coleção retornada será então canalizada para Where-Object, que selecionará apenas as definições cuja propriedade AnonymousUserGracePeriod for maior do que dez minutos (00 horas: 10 minutos: 00 segundos).