Compartilhar via

  • Artigo

New-CsUserServicesConfiguration

 

Tópico modificado em: 2012-04-23

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

Sintaxe

New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 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 de configuração dos Serviços de usuários nos escopos 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 Serviços 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 New-CsUserServicesConfiguration permite aos administradores criarem uma nova coleção de definições de configuração dos Serviços de usuários no escopo de site ou de serviço. (não é possível criar novas coleções no escopo global.) Observe que qualquer site ou serviço determinado pode hospedar, no máximo, apenas uma coleção de definições de configuração dos Serviços de usuários. O comando falhará se você tentar criar as definições para, digamos, o site de Redmond e esse site já hospedar uma coleção de definições de configuração dos Serviços de usuários.

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

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

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

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-se o seguinte formato: dias.horas:minutos:segundos (por exemplo: 0.00:30:00 indica 30 minutos). O período de cortesia pode ser definido como qualquer valor entre 0 e 1 dia; o valor padrão é 90 minutos (01:30:00).

DeactivationGracePeriod

Opcional

TimeSpan

O período máximo em que uma reunião pode permanecer ativa. Esse valor deve ser especificado usando-se o seguinte formato: dias.horas:minutos:segundos. Por exemplo, para permitir que uma reunião dure 60 horas, use o seguinte formato: 2,12:00:00 (2 dias. 12 horas: 00 minutos: 00 segundos).

DeactivationGracePeriod deve se situar entre oito horas e 365 dias. O valor padrão é um dia (1,00:00:00).

DefaultSubscriptionExpiration

Opcional

Inteiro

As assinaturas são criadas sempre que um usuário fizer uma solicitação de dados (informações de presença, por exemplo). Quando a solicitação for feita, o usuário (ou, mais especificamente, o aplicativo cliente do usuário) poderá solicitar o período de validade da assinatura antes que esta necessite ser renovada. Se essa solicitação não for emitida, a assinatura será 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 (oito horas).

MaintenanceTimeOfDay

Opcional

DataHora

Indica a hora do dia em que é realizada a manutenção do banco de dados regularmente agendada (como a limpeza de registros desatualizados). Esse valor deve ser especificado como um valor de data-hora. É possível usar tanto o formato de 24 horas (por exemplo: "14:00") como o formato de 12 horas (por exemplo: "2:00 PM").

O valor padrão de 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. No entanto, é possível usar os cmdlets CsClientPolicy para limitar determinados usuários a um número máximo de contatos menor do que o valor de MaxContacts.

MaxPersonalNotes

Opcional

Inteiro

Indica o número máximo de notas pessoais que são armazenadas no histórico de notas do usuário. Por padrão, as três últimas notas pessoais são mantidas no histórico de notas. O número máximo de notas que podem ser mantidas no histórico é dez.

MaxScheduledMeetingsPerOrganizer

Opcional

Inteiro

O número máximo de reuniões das quais um único usuário pode participar como organizador por um determinado tempo. O valor padrão é 1.000. Isso significa que, se um usuário já for o organizador de 1.000 reuniões, a sua tentativa de agendar uma nova reunião (reunião número 1.001) falhará.

MaxSubscriptionExpiration

Opcional

Inteiro

As assinaturas são criadas sempre que um usuário fizer uma solicitação de dados (informações de presença, por exemplo). Quando a solicitação for feita, o usuário (ou, mais especificamente, o aplicativo cliente do usuário) poderá solicitar o período de validade da assinatura antes que esta necessite ser renovada. A propriedade MaxSubscriptionExpiration representa o período máximo de tempo a ser concedido aos clientes. Por exemplo, se o período máximo for definido como 28800 segundos e um cliente solicitar um intervalo de ociosidade de 86400 segundos, o cliente receberá o período de expiração máximo permitido: 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 caixas de diálogo de assinatura SIP que um usuário pode abrir por vez. Uma caixa de diálogo de assinatura representa uma solicitação de recursos SIP. O valor padrão é 200.

MinSubscriptionExpiration

Opcional

Inteiro

As assinaturas são criadas sempre que um usuário fizer uma solicitação de dados (informações de presença, por exemplo). Quando a solicitação for feita, o usuário (ou, mais especificamente, o aplicativo cliente do usuário) poderá solicitar o período de validade da assinatura antes que esta necessite ser renovada. A propriedade MinSubscriptionExpiration representa o período mínimo de tempo a ser concedido aos clientes. Por exemplo, se o período mínimo for definido como 1200 segundos e um cliente solicitar um intervalo de ociosidade de 200 segundos, o cliente receberá o período de expiração mínimo permitido: 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), os aplicativos cliente poderão se registrar em grupos de distribuição que não estiverem expandidos na Lista de contatos. Isso permite que o cliente mantenha as informações de presença atualizadas para cada membro do grupo. Se ele for definido como False, os aplicativos cliente não poderão se inscrever em grupos "recolhidos".

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir 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-CsUserServicesConfiguration não aceita a entrada canalizada.

Tipos de Retorno

New-CsUserServicesConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Exemplo

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

New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"

O comando exibido no Exemplo 1 cria uma nova coleção de definições de configuração dos Serviços de usuários para o site de Redmond (-Identity site:Redmond). Além de especificar a Identidade, o comando também define o número máximo de contatos (-MaxContacts 500) e a hora do dia em que a manutenção é realizada (-MaintenanceTimeOfDay "11:00 PM"). Observe que esse comando falhará se as definições dos Serviços de usuários já tiverem sido configuradas para o site de Redmond. Isso ocorre porque você está limitado a uma coleção de definições por site.

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

$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500 
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x

O Exemplo 2 também cria uma nova coleção de definições de configuração de Serviços de usuários para o site de Redmond. No entanto, nesse exemplo, a coleção é inicialmente criada na memória e, só mais tarde, será aplicada ao site de Redmond. Para realizar isso, o primeiro comando no exemplo usa New-CsUserServicesConfiguration e o parâmetro InMemory, para criar uma nova coleção (com a Identidade site:Redmond) que existirá apenas na memória. Como essa coleção existe apenas na memória, o objeto Serviços de usuários deve ser armazenado em uma variável. Neste caso, é uma variável denominada $x.

Depois que a coleção virtual tiver sido criada, os comandos 2 e 3 serão utilizados para modificar os valores das propriedades MaxContacts e MaintenanceTimeOfDay. Em seguida, o último comando do exemplo usa Set-CsUserServicesConfiguration para transformar essas definições virtuais em uma coleção real de definições de configuração do Serviços de Usuário aplicada ao site de Redmond. A etapa final é crucial: Se Set-CsUserServicesConfiguration não for chamado, nenhuma definição será aplicada ao site de Redmond e as definições virtuais desaparecerão assim que a sessão do Windows PowerShell for terminada ou a variável $x for excluída.