Compartilhar via

New-SCServicingWindow

Módulo:
VirtualMachineManager Module

Cria uma janela de manutenção e o agendamento para a janela de manutenção.

Sintaxe

WeeklyFrequency 

New-SCServicingWindow
    [-Name] <String>
    -WeeklyScheduleDayOfWeek <String>
    [-VMMServer <ServerConnection>]
    [-Description <String>]
    [-Category <String>]
    [-Owner <String>]
    [-TimeZone <Int32>]
    [-StartDate <DateTime>]
    [-StartTimeOfDay <DateTime>]
    [-WeeksToRecur <Int32>]
    [-MinutesDuration <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

MonthlyRelativeFrequency 

New-SCServicingWindow
    [-Name] <String>
    -MonthlyScheduleDayOfWeek <DayOfWeek>
    -WeekOfMonth <WeekOfMonthType>
    [-VMMServer <ServerConnection>]
    [-Description <String>]
    [-Category <String>]
    [-Owner <String>]
    [-TimeZone <Int32>]
    [-StartDate <DateTime>]
    [-StartTimeOfDay <DateTime>]
    [-MonthsToRecur <Int32>]
    [-MinutesDuration <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

MonthlyFrequency 

New-SCServicingWindow
    [-Name] <String>
    -DayOfMonth <DayOfMonthType>
    [-VMMServer <ServerConnection>]
    [-Description <String>]
    [-Category <String>]
    [-Owner <String>]
    [-TimeZone <Int32>]
    [-StartDate <DateTime>]
    [-StartTimeOfDay <DateTime>]
    [-MonthsToRecur <Int32>]
    [-MinutesDuration <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

DailyFrequency 

New-SCServicingWindow
    [-Name] <String>
    -DaysToRecur <Int32>
    [-VMMServer <ServerConnection>]
    [-Description <String>]
    [-Category <String>]
    [-Owner <String>]
    [-TimeZone <Int32>]
    [-StartDate <DateTime>]
    [-StartTimeOfDay <DateTime>]
    [-MinutesDuration <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet New-SCServicingWindow cria uma janela de manutenção e o agendamento para a janela de manutenção. Uma janela de manutenção é um período de tempo agendado durante o qual o trabalho de manutenção pode ser feito em uma máquina virtual, um host ou um serviço.

Exemplos

Exemplo 1: agendar uma janela de manutenção diária

PS C:\> $Date = (Get-Date).AddDays(2)
PS C:\> New-SCServicingWindow -Name "Backup Staging A" -Category "Non Essential" -StartDate $Date -StartTimeOfDay "13:30" -TimeZone 085 -DaysToRecur 3

O primeiro comando obtém a data atual e adiciona dois dias e, em seguida, armazena o resultado na variável $Date.

O segundo comando cria uma janela de manutenção chamada Backup Staging A que ocorre a cada três dias às 13h30 no fuso horário padrão GMT. A data de início da janela de manutenção é definida como a data armazenada no $Date, que é em dois dias.

Exemplo 2: agendar uma janela de manutenção que ocorre um dia por semana

PS C:\> $Date = (Get-Date).AddDays(7)
PS C:\> New-SCServicingWindow -Name "Test Servers Group 3" -Category "Test Group" -StartDate $Date -StartTimeOfDay "11:00" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday" -WeeksToRecur 1 -MinutesDuration 180

O primeiro comando obtém a data atual e adiciona sete dias (uma semana) e, em seguida, armazena o resultado na variável $Date.

O segundo comando cria uma janela de manutenção chamada Grupo de Servidores de Teste 3 que ocorre semanalmente no sábado a partir das 11:00 no fuso horário do Leste e dura 3 horas (180 minutos). A data de início da janela de manutenção é definida como a data armazenada no $Date, que é em sete dias (uma semana).

Exemplo 3: Agendar uma janela de serviço quinzenal

PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2

Esse comando cria uma janela de manutenção chamada Grupo de Preparo C que ocorre a cada duas semanas (quinzenalmente) no sábado e no domingo, começando às 22h30 no fuso horário do leste. Como nenhuma data de início é especificada, por padrão, a janela de manutenção entra em vigor hoje.

Exemplo 4: Agendar uma janela de manutenção bimestral

PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2

Esse comando cria uma janela de manutenção chamada Servidores de Produção A que ocorre a cada dois meses (bimestralmente) na segunda terça-feira do mês, começando às 23h30 no fuso horário do leste. Como nenhuma data de início é especificada, por padrão, a janela de manutenção entra em vigor hoje.

Parâmetros

-Category

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

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

-DayOfMonth

Especifica o dia ordinal do mês em que o agendamento é iniciado. Por exemplo, 4 indica o quarto dia do mês. Último indica o último dia do mês.

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

  • Valores inteiros válidos: 1 - 31
  • Valores de cadeia de caracteres válidos: Primeiro, Último

Propriedades do parâmetro

Tipo:DayOfMonthType
Valor padrão:None
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
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-DaysToRecur

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Description

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

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

-JobVariable

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

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

-MinutesDuration

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

Propriedades do parâmetro

Tipo:Int32
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

-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 será 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 .

Propriedades do parâmetro

Tipo:DayOfWeek
Valor padrão:None
Valores aceitos:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-MonthsToRecur

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

MonthlyRelativeFrequency
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MonthlyFrequency
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Owner

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

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

-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.

Propriedades do parâmetro

Tipo:Guid
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

-RunAsynchronously

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

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:False
Valor dos argumentos restantes: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 abreviada para sua localidade ou pode passar um objeto DateTime de Get-Date.

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:False
Valor dos argumentos restantes:False

-StartTimeOfDay

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

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:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Int32
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

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 número inteiro: 1, 2, 3, 4, 5, 6, 7

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-WeekOfMonth

Especifica uma semana em relação ao primeiro dia do mês, como primeiro, segundo, terceiro, quarto ou último.

Propriedades do parâmetro

Tipo:WeekOfMonthType
Valor padrão:None
Valores aceitos:First, Second, Third, Fourth, Last
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-WeeksToRecur

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

WeeklyFrequency
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.

Saídas

ServicingWindow

Esse cmdlet retorna um objeto ServicingWindow .