New-AzureAutomationSchedule

  • Referência
Módulo:
Azure

Cria uma agenda de automação.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

New-AzureAutomationSchedule
   -Name <String>
   -StartTime <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureAutomationSchedule
   -Name <String>
   -StartTime <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureAutomationSchedule
   -Name <String>
   -StartTime <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Importante

Este comando do PowerShell para Automação do Azure tem mais suporte a partir de 23/01/2020. O modelo de Gerenciamento de Serviços do Azure foi preterido para a Automação do Azure e foi desabilitado nessa data. Use os comandos que dão suporte ao modelo de Gerenciamento de Recursos do Azure no Az.Automation.

O cmdlet New-AzureAutomationSchedule cria uma agenda na Automação do Microsoft Azure.

Exemplos

Exemplo 1: Criar um cronograma único

PS C:\> New-AzureAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime

O comando a seguir cria uma agenda que é executada uma vez na data atual às 23h00.

Exemplo 2: Criar uma agenda recorrente

PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DailyInterval 1

Os comandos a seguir criam um novo cronograma que é executado às 13:00 todos os dias durante um ano, começando no dia atual.

Parâmetros

-AutomationAccountName

Especifica o nome de uma conta de automação.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DayInterval

Especifica um intervalo, em dias, para a agenda.

Tipo:Byte
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Especifica uma descrição.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ExpiryTime

Especifica o tempo de expiração de uma agenda. Uma cadeia de caracteres pode ser fornecida se puder ser convertida em um DateTime válido.

Tipo:DateTimeOffset
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HourInterval

Especifica um intervalo, em horas, para a agenda.

Tipo:Byte
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica um nome para a agenda.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OneTime

Indica que essa operação cria um cronograma único.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StartTime

Especifica a hora de início de uma agenda. Uma cadeia de caracteres pode ser fornecida se puder ser convertida em um DateTime válido.

Tipo:DateTimeOffset
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Schedule