Compartilhar via

Add-SCOMSubscriberSchedule

  • Referência
Módulo:
OperationsManager

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

Syntax

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

Esse 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 esse assinante para o cmdlet Add-SCOMSubscriberSchedule usando o operador de pipeline.

Exemplo 2: Adicionar várias entradas de agendamento 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 central dos EUA. O comando usa o cmdlet Get-SCOMNotificationSubscriber para obter o assinante especificado e passa esse 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 usando o operador de pipeline. O comando adiciona uma segunda entrada de agendamento com os valores especificados.

Parâmetros

-AllDay

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 de NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado (FQDN). 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:NotificationRecipientScheduleEntryDaysOfWeek
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EndDate

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EndTime

Especifica a hora em que a entrada de agendamento termina.

Type:DateTime
Aliases:To, Until
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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".

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartDate

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StartTime

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

Type:DateTime
Aliases:From
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Subscriber

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

Type:NotificationRecipient
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeZone

Especifica o fuso horário para a entrada de agendamento. Se você especificar curingas como parte do fuso horário, o cmdlet executará correspondência curinga com os 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 esse parâmetro são:

  • UTC+05:00. Estados Unidos hora do Leste.
  • Hora do Pacífico. Estados Unidos hora do Pacífico.
  • Em Amsterdã. Amsterdã, Berlim, Berna, Roma, hora de Estocolmo.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False