Compartilhar via

Set-SmaSchedule

  • Referência
Módulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Cria ou modifica um agendamento no SMA.

Sintaxe

Set-SmaSchedule
   -Name <String>
   [-Description <String>]
   -ScheduleType <String>
   -StartTime <DateTime>
   -ExpiryTime <DateTime>
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-SmaSchedule cria ou modifica um agendamento na SMA (Automação de Gerenciamento de Serviços). Especifique o nome e o tipo da agenda e os horários de início e término.

Você só pode modificar a descrição quando executar esse cmdlet em relação a um agendamento existente. A hora de início, a hora de expiração e o intervalo de dia só podem ser definidos ao criar um agendamento com esse cmdlet.

Exemplos

Exemplo 1: Criar um agendamento

PS C:\> $StartDate = Get-Date 
PS C:\> $EndDate = Get-Date -Day 12 -Month 6 -Year 2023
PS C:\> Set-SmaSchedule -StartTime $StartDate -ExpiryTime $EndDate -Name "Schedule01" -ScheduleType "DailySchedule" -WebServiceEndpoint "https://contoso.com/app01"

O primeiro comando cria um objeto de data usando o cmdlet Get-Date e armazena o objeto na variável $StartDate. Esse objeto reflete a hora atual.

O segundo comando cria um objeto de data usando o cmdlet Get-Date e armazena o objeto na variável $EndDate. O comando especifica uma hora futura. Para obter mais informações, digite Get-Help Get-Date.

O último comando define o agendamento denominado Schedule01 para começar no momento armazenado em $StartDate e terminar no momento armazenado em $EndDate

Parâmetros

-AuthenticationType

Especifica o tipo de autenticação. Os valores válidos são:

  • Básico
  • Windows

O valor padrão para esse parâmetro é Windows. Se você usar a autenticação Básica, deverá fornecer credenciais usando o parâmetro credencial.

Tipo:String
Valores aceitos:Basic, Windows
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 com o serviço Web SMA. Para obter um objeto de credencial, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

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

-Description

Fornece uma descrição para o agendamento.

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

-ExpiryTime

Especifica quando, como um objeto DateTime, o agendamento termina. Para obter um objeto DateTime, use o cmdlet Get-Date. Para obter mais informações, digite Get-Help Get-Date.

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

-Name

Especifica o nome de uma agenda.

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

-Port

Especifica o número da porta do serviço Web SMA.

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

-ScheduleType

Especifica o tipo de agendamento. Os valores válidos para este parâmetro são:

  • OneTimeSchedule
  • DailySchedule
Tipo:String
Valores aceitos:OneTimeSchedule, DailySchedule
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StartTime

Especifica quando, como um objeto DateTime, o agendamento é iniciado. Para obter um objeto DateTime, use o cmdlet Get-Date.

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

-WebServiceEndpoint

Especifica o ponto de extremidade, como UMA URL, do serviço Web SMA. Você deve incluir o protocolo, por exemplo, http:// ou https://.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
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