New-SCServicingWindow
Cria uma janela de manutenção e a agenda da 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 a agenda da janela de manutenção. Uma janela de manutenção é um período 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 3O primeiro comando obtém a data atual e adiciona dois dias e armazena o resultado na variável $Date.
O segundo comando cria uma janela de manutenção chamada Preparação de Backup A que ocorre a cada terceiro dia às 13h30 no fuso horário padrão GMT. A data de início da janela de manutenção é definida como 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 180O primeiro comando obtém a data atual e adiciona sete dias (uma semana) e 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 11h no fuso horário leste e dura 3 horas (180 minutos). A data de início da janela de manutenção é definida como a data armazenada em $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 2Esse 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 2Esse 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 23h30, no fuso horário 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
- Valores inteiros válidos: 1 a 31
- Valores de cadeia de caracteres 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 agendados. O valor padrão é o valor mínimo de um (1). O valor máximo é 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 andamento do trabalho é controlado e armazenado na variável nomeada por esse 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. Use esse parâmetro para especificar a quantidade de tempo para a qual 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 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 esse parâmetro são:
- Monday
- Terça-feira
- Quarta-feira
- Quinta-feira
- Friday
- Sábado
- Sunday
Requisito: use 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 agendadas. O valor padrão é o valor mínimo de 1. Não há 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 VMM (Virtual Machine Manager).
| 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 na forma de uma conta de usuário de domínio válido.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell 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 padrão é a data atual. Você pode digitar uma nova data no formato de data curta para sua localidade ou passar um objeto DateTime do 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 padrão é 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 compartilha o mesmo tempo padrão.
Para obter uma lista de índices de fuso horário, consulte os 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do 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 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
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WeekOfMonth
Especifica uma semana relativa ao primeiro dia do mês, como 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 agendados. O valor padrão é o valor mínimo de um (1). Não há 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 retorna um objeto ServicingWindow .