New-CsRgsTimeRange
Tópico modificado em: 2012-03-23
Cria um novo intervalo de tempo do Grupo de Resposta. Os intervalos de tempo são usados pelo Aplicativo Grupo de Resposta para especificar horários de abertura e fechamento de um dia útil. Por exemplo, se os operadores da assistência técnica estiverem disponíveis somente das 12:00 às 17:00 aos domingos, seria criado um intervalo de tempo no domingo que tivesse o horário de abertura às 12:00 e o horário de fechamento às 17:00.
Sintaxe
New-CsRgsTimeRange -CloseTime <Nullable> -OpenTime <Nullable> [-Name <String>]
Descrição Detalhada
O Aplicativo Grupo de Resposta usa coleções de horários comerciais para acompanhar os dias da semana e os horários do dia em que esses operadores estão normalmente disponíveis para atender ao telefone. Por exemplo, suponha que sua assistência técnica esteja aberta todas as segundas-feiras das 07:00 às 19:00. Nesse caso, será necessário fazer duas coisas: utilizar o cmdlet New-CsRgsHoursOfBusiness para criar uma coleção de horários comerciais para a assistência técnica e modificar a propriedade MondayTimeRange1, para indicar que a assistência técnica abre às 07:00 e fecha às 19:00.
A modificação de uma coleção de horários comerciais existente requer a utilização do cmdlet Set-CsRgsHoursOfBusiness. Entretanto, não é possível utilizar esse cmdlet para modificar diretamente uma propriedade de intervalo de tempo; por exemplo, Set-CsRgsHoursOfBusiness não possui parâmetros que correspondam à propriedade MondayTimeRange1. Em vez disso, a modificação de uma coleção de horários comerciais exige a recuperação dessa coleção usando-se Get-CsRgsHoursOfBusiness, a realização de alterações à coleção somente na memória e a utilização de Set-CsRgsHoursOfBusiness, para gravar essas alterações na coleção real de horários comerciais.
Frequentemente, as alterações feitas a uma coleção de horários comerciais envolvem a modificação dos horários de abertura e/ou fechamento em um determinado dia (ou dias). Para modificar os horários de abertura e fechamento, é necessário especificar esses horários utilizando-se o cmdlet New-CsRgsTimeRange. Quando se chama esse cmdlet, o valor resultante deve ser armazenado em uma variável de referência de objeto. Essa variável será utilizada para definir os horários de abertura e fechamento nos limites dos horários comerciais da coleção.
Também deve-se utilizar New-CsRgsTimeRange, para especificar os horários de abertura e fechamento sempre que se criar uma nova coleção de horários comerciais.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsRgsTimeRange localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. No entanto, como esse cmdlet cria um objeto na memória e, isoladamente, não faz alterações ao sistema, ele pode ser executado por qualquer pessoa. Para retornar uma lista de todas as funções do 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 do prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsTimeRange"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
CloseTime |
Obrigatório |
TimeSpan |
A hora do dia em que termina o horário comercial. CloseTime deve ser formatado utilizando-se um relógio de 24 horas. Por exemplo, para indicar que o horário comercial termina às 09:00 PM, utilize este formato: -CloseTime "21:00". |
OpenTime |
Obrigatório |
TimeSpan |
A hora do dia em que se inicia o horário comercial. OpenTime deve ser formatado utilizando-se um relógio de 24 horas. Por exemplo, para indicar que o horário comercial começa às 01:30 PM, utilize este formato: -OpenTime "13:30". |
Name |
Opcional |
Cadeia de caracteres |
Identificador exclusivo do intervalo de tempo sendo criado. Nome é limitado ao número máximo de 128 caracteres. |
Tipos de Entrada
Nenhum. New-CsRgsTimeRange não aceita a entrada pipelined.
Tipos de Retorno
New-CsRgsTimeRange cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.TimeRange.
Exemplo
-------------------------- Exemplo 1 ------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
$y = Get-CsRgsHoursOfBusiness -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours"
$y.SundayHours1 = $sundayHours
Set-CsRgsHoursOfBusiness -Instance $y
O exemplo anterior mostra como se pode utilizar o cmdlet New-CsRgsTimeRange para modificar as propriedades de um conjunto existente de horários comerciais. Neste exemplo, inicialmente chama-se New-CsRgsTimeRange para criar um novo intervalo de tempo denominado "Horários do domingo". Esse intervalo de tempo define como 8:30 o horário de abertura e como 13:30 o horário de fechamento. O intervalo de tempo somente na memória criado por esse comando será armazenado em uma variável denominada $sundayHours.
Após a configuração do intervalo de tempo, o segundo comando no exemplo utilizará o cmdlet Get-CsRgsHoursOfBusiness para retornar a coleção de horários comerciais denominada Horários da Assistência Técnica (encontrada no serviço ApplicationServer:atl-cs-001.litwareinc.com). A coleção retornada é armazenada em uma variável denominada $y.
Após a recuperação da coleção, o comando 3 define o valor da propriedade SundayHours1 como sendo $sundayHours, a referência de objeto contendo o intervalo de tempo recém-criado. Quando esse comando for concluído, Set-CsRgsHoursOfBusiness será utilizado para gravar as alterações na coleção de horários comerciais Horários da Assistência Técnica. Observe que, se não for possível chamar Set-CsRgsHoursOfBusiness, o intervalo de tempo recém-criado existirá somente na memória e desaparecerá no momento em que se fechar o Windows PowerShell ou se excluir a variável $sundayHours. Se isso ocorrer, a coleção de horários comerciais Horários da Assistência Técnica não será atualizada.
-------------------------- Exemplo 2 ------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
New-CsRgsHoursOfBusiness -Parent Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours" -SundayHours1 $sundayHours
O Exemplo 2 mostra como se pode criar um novo intervalo de tempo do Grupo de Resposta e, em seguida, utilizar esse intervalo de tempo em um novo conjunto de horários comerciais. O primeiro comando no exemplo utiliza o cmdlet New-CsRgsTimeRange para criar um novo intervalo de tempo denominado Horários do Domingo. OpenTime do intervalo é definido como 8:30 ("08:30:") e CloseTime, como 13:30 ("13:30" – 13 horas e 30 minutos – utilizando o formato de 24 horas). O objeto de intervalo de tempo resultante será armazenado em uma variável denominada $sundayHours.
No segundo comando, o cmdlet New-CsRgsBusinessHours é utilizado para criar uma nova coleção de horários comerciais, denominada Horários da Assistência Técnica. Nesse comando, a variável $sundayHours especifica o intervalo de tempo da propriedade SundayHours1.