Compartilhar via

Set-SCServicingWindow

  • Referência
Módulo:
VirtualMachineManager

Modifica as propriedades de uma janela de manutenção.

Sintaxe

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -WeeklyScheduleDayOfWeek <String>
   [-WeeksToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -MonthlyScheduleDayOfWeek <DayOfWeek>
   -WeekOfMonth <WeekOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DayOfMonth <DayOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DaysToRecur <Int32>
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCServicingWindow modifica as propriedades de uma janela de manutenção, incluindo o agendamento da janela de manutenção.

Exemplos

Exemplo 1: alterar a hora de início de uma janela de manutenção

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A" 
PS C:\> Set-SCServicingWindow -ServicingWindow $SvcWindow -StartTimeOfDay "13:00" -TimeZone 085

O primeiro comando obtém o objeto da janela de manutenção chamado Preparação de Backup A e armazena o objeto na variável $SvcWindow.

O segundo comando altera a hora de início da janela de manutenção armazenada em $SvcWindow (Preparação de Backup A) para 13h no fuso horário padrão GMT.

Parâmetros

-Category

Especifica uma categoria para uma janela de manutenção.

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

-DayOfMonth

Especifica o dia ordinal do mês no qual a agenda é iniciada. Por exemplo, 4 indica o quarto dia do mês. O último indica o último dia do mês.

O valor padrão é o inteiro que corresponde ao mesmo dia especificado no parâmetro StartDate do .

Valores inteiros válidos: 1 a 31

Valores de cadeia de caracteres válidos: Primeiro, Último

Tipo:DayOfMonthType
Valores aceitos:First, DayTwo, DayThree, DayFour, DayFive, DaySix, DaySeven, DayEight, DayNine, DayTen, DayEleven, DayTweleve, DayThirteen, DayFourteen, DayFifteen, DaySixteen, DaySeventeen, DayEighteen, DayNineteen, DayTwenty, DayTwentyOne, DayTwentyTwo, DayTwentyThree, DayTwentyFour, DayTwentyFive, DayTwentySix, DayTwentySeven, DayTwentyEight, DayTwentyNine, DayThirty, DayThirtyOne, Last
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DaysToRecur

Especifica a quantidade de tempo, em dias, entre trabalhos agendados. O valor padrão é o mínimo de um (1). O valor máximo é 999.

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

-Description

Especifica uma descrição para a janela de manutenção.

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

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

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

-MinutesDuration

Especifica um período de tempo em minutos. Use esse parâmetro para especificar o tempo para o qual colocar um servidor ou serviço no modo de manutenção.

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

-MonthlyScheduleDayOfWeek

Especifica o dia da semana para executar um trabalho que ocorre em um agendamento mensal. Você pode especificar apenas um dia da semana. O valor padrão é o dia atual (se hoje for terça-feira, terça-feira é o padrão). Os valores aceitáveis para este parâmetro são:

  • Segunda-feira
  • Terça-feira
  • Quarta-feira
  • Quinta-feira
  • Sexta-feira
  • Sábado
  • Domingo

Requisito: use com o parâmetro WeekOfMonth.

Tipo:DayOfWeek
Valores aceitos:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MonthsToRecur

Especifica a quantidade de tempo, em meses, entre janelas de serviço agendadas. O valor padrão é o valor mínimo de um (1). Não há valor máximo.

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

-Name

Especifica o nome de um objeto VMM (Virtual Machine Manager).

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

-Owner

Especifica o proprietário de um objeto VMM na forma de uma conta de usuário de domínio válida.

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

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

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

-ServicingWindow

Especifica um objeto de janela de manutenção.

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

-StartDate

Especifica a data para iniciar uma janela de serviço. O valor padrão é a data atual. Você pode digitar uma nova data no formato de data curta para sua localidade ou passar um objeto DateTime de Get-Date.

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

-StartTimeOfDay

Especifica a hora do dia, ou um período de tempo durante um período de 24 horas, para iniciar um trabalho ou outra operação. O valor padrão é a hora atual.

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

-TimeZone

Especifica um número (um índice) que identifica uma região geográfica que compartilha o mesmo tempo padrão. Para obter uma lista de índices de fuso horário, consulte valores de índice de fuso horário da Microsoft em http://go.microsoft.com/fwlink/?LinkId=120935. Se nenhum fuso horário for especificado, o fuso horário padrão usado para uma máquina virtual será a mesma configuração de fuso horário que está no host da máquina virtual.

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

-WeeklyScheduleDayOfWeek

Especifica um ou mais dias da semana para executar um trabalho. O valor padrão é o dia atual da semana.

Valores válidos para especificar um dia individual usando uma cadeia de caracteres: segunda- feira, terça-feira, quarta-feira, quinta-feira, sexta-feira, sábado, domingo.

Valores válidos para especificar um conjunto de dias em uma semana: qualquer conjunto de dois ou mais dias separados por vírgulas.

Valores válidos para especificar um dia individual usando um inteiro: 1, 2, 3, 4, 5, 6, 7

Requisito: usar comStartTimeOfDay .

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

-WeekOfMonth

Especifica uma semana relativa ao primeiro dia do mês, como primeiro, segundo, terceiro, quarto ou último.

Tipo:WeekOfMonthType
Valores aceitos:First, Second, Third, Fourth, Last
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WeeksToRecur

Especifica a quantidade de tempo, em semanas, entre trabalhos agendados. O valor padrão é o valor mínimo de um (1). Não há valor máximo.

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

Saídas

ServicingWindow

Esse cmdlet retorna um objeto ServicingWindow.