Compartilhar via

  • Artigo

Set-CsUserServicesConfiguration

 

Tópico modificado em: 2012-04-23

Modifica uma coleção existente de configurações dos Serviços do Usuário. O serviço Serviços do Usuário é usado para ajudar a manter as informações de presença e gerenciar as conferências.

Sintaxe

Set-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsUserServicesConfiguration [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 depende do serviço Serviços do Usuário para ajudar a manter as informações de presença dos usuários e gerenciar as reuniões e conferências. Por sua vez, os cmdlets CsUserServicesConfiguration são usados para administrar as configurações dos Serviços do Usuário em escopo global, de site e de serviço (observe que o único serviço que pode hospedar as configurações dos Serviços do Usuário é o próprio serviço Serviços do Usuário). Essas configurações ajudam a determinar coisas como a quantidade de contatos que um usuário pode ter, a quantidade de reuniões que um usuário pode agendar e por quanto tempo uma reunião pode permanecer ativa.

O cmdlet Set-CsUserServicesConfiguration é uma forma dos administradores modificarem informações sobre quaisquer das (ou todas as) configurações dos Serviços do Usuário que estejam em uso no momento.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsUserServicesConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo para as configurações do serviço Serviços do Usuário a serem modificadas. Para modificar as configurações globais, use esta sintaxe: -Identity global. Para modificar definições configuradas no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para modificar configurações no nível de serviço, use uma sintaxe como esta: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Instance

Opcional

Objeto UserServicesSettings

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

AnonymousUserGracePeriod

Opcional

TimeSpan

Representa o período de tempo que um usuário anônimo (não autenticado) pode permanecer em uma reunião sem que haja um usuário autenticado presente na mesma reunião. Por exemplo, se esse valor for definido como 15 minutos, um usuário anônimo poderá permanecer na reunião por, no máximo, 15 minutos antes da entrada de um usuário autenticado. Se nenhum usuário autenticado entrar na reunião antes que o período de cortesia expire, o usuário anônimo será removido da reunião. Esta configuração é aplicada às reuniões programadas e reuniões locais criadas clicando em Reunir agora no Microsoft Lync.

AnonymousUserGracePeriod deve ser especificado usando o seguinte formato: dias.minutos:segundos (por exemplo, 0.00:30:00 para 30 minutos). O período de cortesia pode ser definido como qualquer valor entre 0 segundos e 1 dia; o valor padrão é de 90 minutos (01:30:00).

DeactivationGracePeriod

Opcional

TimeSpan

O tempo máximo que uma reunião pode permanecer ativa. O valor deve ser especificado usando o seguinte formato: dias.horas:minutos:segundos. Por exemplo, para que uma reunião possa durar 60 horas, use este formato: 2.12:00:00 (2 dias: 12 horas: 00 minutos : 00 segundos)

DeactivationGracePeriod deve estar entre 8 horas e 365 dias, inclusive. O valor padrão é 1 dia.

DefaultSubscriptionExpiration

Opcional

Inteiro

Assinaturas são criadas quando um usuário solicita dados como informações de presença. Quando a solicitação é feita, o usuário (ou, mais corretamente, o aplicativo cliente do usuário) pode solicitar o período pelo qual a assinatura permanecerá válida antes de ser renovada. Se nenhuma solicitação desse tipo for emitida, a assinatura é definida com o valor especificado pela propriedade DefaultSubscriptionExpiration.

O tempo padrão de assinatura deve ser expresso como um valor de número inteiro entre 300 segundos (5 minutos) e 86400 segundos (24 horas), inclusive. O valor padrão é 28800 segundos (8 horas).

MaintenanceTimeOfDay

Opcional

DateTime

Indica a hora em que ocorre a manutenção de banco de dados agendada regularmente (como a limpeza de registros desatualizados). O valor deve ser especificado como um valor data-hora; use o formato de 24 horas (por exemplo, "14:00") ou o formato de 12 horas (por exemplo, "2:00 PM").

O valor padrão para MaintenanceTimeOfDay é 1:00 AM (01:00:00).

MaxContacts

Opcional

Inteiro

O número máximo de contatos que um usuário pode ter; o valor padrão é 250. A propriedade MaxContacts representa a quantidade máxima absoluta de contatos que um usuário pode ter. Porém, os cmdlets CsClientPolicy podem ser usados para limitar certos usuários a um número máximo de contatos inferior ao valor de MaxContacts.

MaxPersonalNotes

Opcional

Inteiro

Especifica o número máximo de anotações pessoais que são armazenadas no histórico de anotações do usuário. Por padrão, as três últimas anotações pessoais são mantidas no histórico de anotações. É possível manter no máximo dez notas no histórico.

MaxScheduledMeetingsPerOrganizer

Opcional

Inteiro

A quantidade máxima de reuniões nas quais um mesmo usuário pode ser organizador em um dado momento. O valor padrão é 1000; isso quer dizer que, se um usuário já for organizador de 1000 reuniões, sua tentativa de agendamento de uma nova reunião (a 1001ª) irá falhar.

MaxSubscriptionExpiration

Opcional

Inteiro

Assinaturas são criadas quando um usuário solicita dados como informações de presença. Quando a solicitação é feita, o usuário (ou, mais corretamente, o aplicativo cliente do usuário) pode solicitar o período pelo qual a assinatura permanecerá válida antes de ser renovada. A propriedade MaxSubscriptionExpiration representa a quantidade máxima de tempo que pode ser concedida aos clientes. Por exemplo, se o tempo máximo for definido como 28800 segundos e um cliente solicitar um intervalo de tempo limite de 86400 segundos, o cliente receberá o período máximo permitido para expiração: 28800 segundos.

O tempo máximo de assinatura deve ser expresso como um valor de número inteiro entre 300 segundos (5 minutos) e 86400 segundos (24 horas), inclusive. O valor padrão é 43200 segundos (12 horas).

MaxSubscriptions

Opcional

Inteiro

O número máximo de diálogos de assinatura de SIP que um usuário pode ter abertos simultaneamente. Um diálogo de assinatura representa uma solicitação por recursos SIP.

MinSubscriptionExpiration

Opcional

Inteiro

Assinaturas são criadas quando um usuário solicita dados como informações de presença. Quando a solicitação é feita, o usuário (ou, mais corretamente, o aplicativo cliente do usuário) pode solicitar o período pelo qual a assinatura permanecerá válida antes de ser renovada. A propriedade MinSubscriptionExpiration representa a quantidade mínima de tempo que pode ser concedida aos clientes. Por exemplo, se o tempo mínimo for definido como 1200 segundos e um cliente solicitar um intervalo de tempo limite de 200 segundos, o cliente receberá o período mínimo permitido para expiração: 1200 segundos.

O tempo mínimo de assinatura deve ser expresso como um valor de número inteiro entre 300 segundos (5 minutos) e 86400 segundos (24 horas), inclusive. O valor padrão é 1200 segundos (20 minutos).

SubscribeToCollapsedDG

Opcional

Booleano

Se for definido como True (o valor padrão), aplicativos cliente poderão assinar grupos de distribuição que não estejam expandidos no momento na lista de Contatos. Isso permite ao cliente manter informações de presença atualizadas para cada membro do grupo. Se for definido como False, os aplicativos cliente não poderão assinar grupos “recolhidos”.

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ser geradas pela execução do comando.

WhatIf

Opcional

Parâmetros de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings. Set-CsUserServicesConfiguration aceita instâncias em pipeline do objeto de configurações de serviços de usuário.

Tipos de Retorno

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

Exemplo

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

Set-CsUserServicesConfiguration -Identity site:Redmond -AnonymousUserGracePeriod "00:30:00"

O comando mostrado no Exemplo 1 modifica as configurações de Serviços do Usuário para o site Redmond (-Identity site:Redmond). Nesse exemplo, AnonymousUserGracePeriod é definido como 30 minutos (00 horas: 30 minutos: 00 segundos).

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

Set-CsUserServicesConfiguration -Identity site:Redmond -MaintenanceTimeOfDay "13:30"

No Exemplo 2, a propriedade MaintenanceTimeOfDay é modificada para as configurações de Serviços do Usuário aplicadas ao site Redmond. Isso é feito com o parâmetro MaintenanceTimeOfDay e o valor de parâmetro 13:30, definindo o horário de manutenção em 1:30 PM (13 horas e 30 minutos em um relógio de 24 horas).

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

Get-CsUserServicesConfiguration -Filter "service:*" | Set-CsUserServicesConfiguration -MaxContacts 300

O comando anterior recupera todas as configurações de Serviços do Usuário aplicadas em escopo de serviço e modifica a quantidade de contatos permitida para cada um desses itens. Para executar esta tarefa, o comando usa primeiro Get-CsUserServicesConfiguration e o parâmetro Filter para recuperar todas as configurações que foram definidas em escopo de serviço; o valor de filtro "service:*" limita os dados retornados a configurações que tenham uma Identidade começando com os caracteres “service:". Esta coleção filtrada é passada para Set-CsUserServicesConfiguration, que toma cada item na coleção e define a propriedade MaxContacts em 300.

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

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

No Exemplo 4, todas as configurações de Serviços do Usuário que permitam que usuários tenham mais de 300 contatos são modificadas; após as modificações, nenhuma configuração permitirá mais de 300 contatos. Para fazer isso, o comando chama primeiro Get-CsUserServicesConfiguration sem parâmetros adicionais. Isso retorna uma coleção de todas as definições de configuração de Serviços do Usuário em uso na organização. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas as configurações nas quais a propriedade MaxContacts seja maior do que 300. Por sua vez, a coleção filtrada é canalizada para Set-CsUserServicesConfiguration, que toma cada item na coleção filtrada e altera a quantidade máxima de contatos permitidos para 300.