New-AzureAutomationSchedule

Referência

Módulo:: Azure

Cria uma agenda de automação.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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 suporte por mais tempo 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 uma agenda única

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 23:00.

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 uma nova agenda que é executada às 13:00 todos os dias por um ano a partir do dia atual.

Parâmetros

-AutomationAccountName

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

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

-DayInterval

Especifica um intervalo, em dias, para a agenda.

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

-Description

Especifica uma descrição.

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

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

-HourInterval

Especifica um intervalo, em horas, para a agenda.

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

-Name

Especifica um nome para a agenda.

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

-OneTime

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

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

-Profile

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

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

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

Saídas

Schedule