Partilhar via

Add-SCOMSubscriberSchedule

  • Referência
Módulo:
OperationsManager

Adiciona uma nova entrada de agenda para um assinante de notificação.

Sintaxe

Add-SCOMSubscriberSchedule
   -Subscriber <NotificationRecipient>
   [-Exclude]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [[-DayOfWeek] <NotificationRecipientScheduleEntryDaysOfWeek>]
   [-StartTime] <DateTime>
   [-EndTime] <DateTime>
   [-TimeZone <String>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCOMSubscriberSchedule
   -Subscriber <NotificationRecipient>
   [-Exclude]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [[-DayOfWeek] <NotificationRecipientScheduleEntryDaysOfWeek>]
   [-TimeZone <String>]
   [-PassThru]
   [-AllDay]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Add-SCOMSubscriberSchedule adiciona uma nova entrada de agendamento para um assinante de notificação. Os assinantes de notificação são usuários que recebem notificações quando o System Center – Operations Manager gera um alerta em um sistema monitorado.

Se você não adicionar entradas à agenda existente de um assinante, o assinante continuará recebendo notificações.

Exemplos

Exemplo 1: adicionar uma agenda para um assinante de notificação

PS C:\>Get-SCOMNotificationSubscriber "Katarina" | Add-SCOMSubscriberSchedule -StartTime "9:00 AM" -EndTime "5:00 PM" -DayOfWeek Monday, Wednesday, Friday

Este comando adiciona uma janela de agendamento das 9h às 17h às segundas, quartas e sextas-feiras em todos os intervalos de datas para um assinante de notificação chamado Katarina. O comando usa o cmdlet Get-SCOMNotificationSubscriber para obter o assinante especificado e passa o assinante para o cmdlet Add-SCOMSubscriberSchedule usando o operador de pipeline.

Exemplo 2: adicionar várias entradas de agenda para um assinante de notificação

PS C:\>Get-SCOMNotificationSubscriber "Cesar" | Add-SCOMSubscriberSchedule -StartTime "7:00 AM" -EndTime "4:00 PM" -DayOfWeek Monday, Wednesday, Friday -TimeZone "*UTC-06:00*" -PassThru | Add-SCOMSubscriberSchedule -StartDate '2012/1/1' -EndDate '2012/1/15' -TimeZone "*UTC-06:00*" -Exclude

Esse comando adiciona duas entradas de agenda ao assinante de notificação chamado Cesar no fuso horário do USA Central. O comando usa o cmdlet Get-SCOMNotificationSubscriber para obter o assinante especificado e passa o assinante para o cmdlet Add-SCOMSubscriberSchedule usando o operador de pipeline. O comando adiciona a entrada com os valores especificados. O comando especifica o parâmetro PassThru para passar o usuário para outra instância do cmdlet Add-SCOMSubscriberSchedule do usando o operador de pipeline. O comando adiciona uma segunda entrada de agenda com os valores especificados.

Parâmetros

-AllDay

Indica que a entrada de agendamento se aplica ao dia inteiro.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Os formatos válidos incluem um nome NetBIOS, um endereço IP ou um FQDN (nome de domínio totalmente qualificado). Para especificar o computador local, especifique o nome do computador, localhost ou um ponto (.).

O computador deve executar o serviço de Acesso a Dados do System Center.

Se você não especificar esse parâmetro, o padrão será o computador para a conexão do grupo de gerenciamento atual.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite "Get-Help Get-Credential".

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DayOfWeek

Especifica os dias da semana em que a entrada de agendamento é válida. Por padrão, a entrada se aplica a todos os dias da semana.

Tipo:NotificationRecipientScheduleEntryDaysOfWeek
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EndDate

Especifica a data em que a entrada de agendamento termina. Se esse comando não especificar parâmetros StartDate e EndDate, a entrada de agendamento se aplicará a todas as datas.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EndTime

Especifica a hora em que a entrada de agendamento termina.

Tipo:DateTime
Aliases:To, Until
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Exclude

Indica que o comando exclui os horários e datas especificados da agenda. Se esse parâmetro não aparecer, o agendamento incluirá apenas os horários especificados.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter objetos Connection, especifique o cmdlet Get-SCOMManagementGroupConnection .

Se esse parâmetro não aparecer, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential. Para obter mais informações, digite "Get-Help about_OpsMgr_Connections".

Tipo:Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StartDate

Especifica a data em que a entrada de agendamento é iniciada. Se esse comando não especificar parâmetros StartDate e EndDate, a entrada de agendamento se aplicará a todas as datas.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StartTime

Especifica a hora de início da entrada de agendamento.

Tipo:DateTime
Aliases:From
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Subscriber

Especifica o assinante de notificação. Para obter um objeto de assinante de notificação, use o cmdlet Get-SCOMNotificationSubscriber ou crie um novo objeto usando o cmdlet Add-SCOMNotificationSubscriber.

Tipo:NotificationRecipient
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TimeZone

Especifica o fuso horário para a entrada de agendamento. Se você especificar caracteres curinga como parte do fuso horário, o cmdlet executará a correspondência curinga em relação aos nomes de exibição para fusos horários. Se esse parâmetro não aparecer, o cmdlet usará como padrão o fuso horário do usuário atual.

Exemplos de valores válidos para este parâmetro são:

  • UTC+05:00. Hora do Leste dos Estados Unidos.
  • horário do Pacífico. Hora do Pacífico dos Estados Unidos.
  • Amsterdã. Hora de Amsterdã, Berlim, Berna, Roma, Estocolmo.
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False