Compartilhar via

Add-SCOMSubscriberSchedule

Módulo:
OperationsManager Module

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

Sintaxe

StartAndEnd 

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

AllDay 

Add-SCOMSubscriberSchedule
    [[-DayOfWeek] <NotificationRecipientScheduleEntryDaysOfWeek>]
    -Subscriber <NotificationRecipient>
    [-Exclude]
    [-StartDate <DateTime>]
    [-EndDate <DateTime>]
    [-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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AllDay
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:NotificationRecipientScheduleEntryDaysOfWeek
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EndTime

Especifica a hora em que a entrada de agendamento termina.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Para, Até

Conjuntos de parâmetros

StartAndEnd
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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".

Propriedades do parâmetro

Tipo:

Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-StartTime

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

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:De

Conjuntos de parâmetros

StartAndEnd
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:NotificationRecipient
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.