New-SCServicingWindow

Módulo:

VirtualMachineManager

Cria uma janela de manutenção e o horário para a janela de manutenção.

Syntax

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-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>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-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>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-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>]

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-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 New-SCServicingWindow cria uma janela de manutenção e o horário para a janela de manutenção. Uma janela de manutenção é um período de tempo programado durante o qual os trabalhos de manutenção podem ser feitos numa máquina virtual, num hospedeiro ou num 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, 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 13:30 no fuso horário GMT Standard. A data de início da janela de manutenção é definida para a data armazenada em $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), depois armazena o resultado na variável $Date.

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

Exemplo 3: Agende uma janela de serviço quinzenal

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

Este comando cria uma janela de manutenção chamada Grupo C de paragem que ocorre de duas em duas semanas (quinzenalmente) no sábado e domingo a partir das 22:30 no fuso horário oriental. Como não é especificada a data de início, por padrão a janela de manutenção torna-se eficaz hoje em dia.

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

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

Este 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, a partir das 23:30 no fuso horário oriental. Como não é especificada a data de início, por padrão a janela de manutenção torna-se eficaz hoje em dia.

Parâmetros

-Category

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

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

-DayOfMonth

Especifica o dia ordinárico do mês em que a programação começa. Por exemplo, 4 indica o quarto dia do mês. O último indica o último dia do mês.

O valor predefinido é o número inteiro que corresponde ao mesmo dia especificado no parâmetro StartDate .

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

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

-DaysToRecur

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

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

-Description

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

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

-JobVariable

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

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

-MinutesDuration

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

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

-MonthlyScheduleDayOfWeek

Especifica o dia da semana para executar um trabalho que ocorre em horário mensal. Pode especificar apenas um dia da semana. O valor predefinido é o dia atual (se hoje é 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
• Saturday
• Sunday

Requisito: Utilizar com o parâmetro WeekOfMonth .

Type:	DayOfWeek
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthsToRecur

Especifica a quantidade de tempo, em meses, entre janelas de serviço programadas. O valor predefinido é o valor mínimo de 1. Não existe nenhum valor máximo.

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

-Name

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

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

-Owner

Especifica o proprietário de um objeto do VMM sob a forma de uma conta de utilizador de domínio válida.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-StartDate

Especifica a data para iniciar uma janela de serviço. O valor predefinido é a data atual. Pode escrever uma nova data no formato de data curta para o seu local, ou, pode passar um objeto DateTime a partir de Get-Date.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 predefinido é a hora atual.

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

-TimeZone

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

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

-VMMServer

Especifica um objeto de servidor VMM.

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

-WeeklyScheduleDayOfWeek

Especifica um ou mais dias da semana para gerir um emprego. O valor predefinido é o dia atual da semana.

• Valores válidos para especificar um dia individual usando uma corda: segunda, terça, quarta, quinta, sexta, sábado, domingo.
• Valores válidos para especificar um conjunto de dias numa 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

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

-WeekOfMonth

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

Type:	WeekOfMonthType
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WeeksToRecur

Especifica a quantidade de tempo, em semanas, entre trabalhos programados. O valor predefinido é o valor mínimo de um (1). Não existe nenhum valor máximo.

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

Saídas

ServicingWindow

Este cmdlet devolve um objeto ServicingWindow .

Ligações Relacionadas

• Get-SCServicingWindow
• Remove-SCServicingWindow
• Set-SCServicingWindow