Condividi tramite

New-SCServicingWindow

  • Riferimento
Modulo:
VirtualMachineManager

Crea una finestra di manutenzione e la pianificazione per la finestra di manutenzione.

Sintassi

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

Descrizione

Il cmdlet New-SCServicingWindow crea una finestra di manutenzione e la pianificazione per la finestra di manutenzione. Una finestra di manutenzione è un intervallo di tempo pianificato durante il quale il lavoro di manutenzione può essere eseguito in una macchina virtuale, in un host o in un servizio.

Esempio

Esempio 1: Pianificare una finestra di manutenzione giornaliera

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

Il primo comando ottiene la data corrente e aggiunge due giorni, quindi archivia il risultato nella variabile $Date.

Il secondo comando crea una finestra di manutenzione denominata Backup staging A che si verifica ogni terzo giorno alle 13:30 nel fuso orario standard GMT. La data di inizio della finestra di manutenzione viene impostata sulla data archiviata in $Date, ovvero in due giorni.

Esempio 2: Pianificare una finestra di manutenzione che si verifica un giorno alla settimana

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

Il primo comando ottiene la data corrente e aggiunge sette giorni (una settimana), quindi archivia il risultato nella variabile $Date.

Il secondo comando crea una finestra di manutenzione denominata Test Servers Group 3 che si verifica settimanalmente il sabato a partire dalle 11:00 am nel fuso orario orientale e dura per 3 ore (180 minuti). La data di inizio della finestra di manutenzione viene impostata sulla data archiviata in $Date, ovvero in sette giorni (una settimana).

Esempio 3: Pianificare una finestra di servizio bisettimanale

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

Questo comando crea una finestra di manutenzione denominata Gruppo di gestione temporanea C che si verifica ogni altra settimana (bisettimanale) sabato e domenica a partire dalle 10:30 nel fuso orario orientale. Poiché non viene specificata alcuna data di inizio, per impostazione predefinita la finestra di manutenzione diventa effettiva oggi.

Esempio 4: Pianificare una finestra di manutenzione bimonthly

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

Questo comando crea una finestra di manutenzione denominata Server di produzione A che si verifica ogni altro mese (bimonthly) il secondo martedì del mese, a partire dalle 11:30 nel fuso orario orientale. Poiché non viene specificata alcuna data di inizio, per impostazione predefinita la finestra di manutenzione diventa effettiva oggi.

Parametri

-Category

Specifica una categoria per una finestra di manutenzione.

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

-DayOfMonth

Specifica il giorno ordinale del mese in cui viene avviata la pianificazione. Ad esempio, 4 indica il quarto giorno del mese. Last indica l'ultimo giorno del mese.

Il valore predefinito è il numero intero che corrisponde allo stesso giorno specificato nel parametro StartDate .

  • Valori interi validi: 1 - 31
  • Valori stringa validi: First, Last
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

Specifica la quantità di tempo, espressa in giorni, tra i processi pianificati. Il valore predefinito è il valore minimo di uno (1). Il valore massimo è 999.

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

-Description

Specifica una descrizione per la finestra di manutenzione.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-MinutesDuration

Specifica un periodo di tempo in minuti. Utilizzare questo parametro per specificare la quantità di tempo per cui inserire un server o un servizio in modalità di manutenzione.

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

-MonthlyScheduleDayOfWeek

Specifica il giorno della settimana per eseguire un processo che si verifica in base a una pianificazione mensile. È possibile specificare un solo giorno della settimana. Il valore predefinito è il giorno corrente (se oggi è martedì, martedì è l'impostazione predefinita). I valori validi per questo parametro sono:

  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Sabato
  • Sunday

Requisito: usare con il parametro 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

Specifica la quantità di tempo, espressa in mesi, tra le finestre di servizio pianificate. Il valore predefinito è il valore minimo 1. Non è previsto alcun valore massimo.

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

-Name

Specifica il nome di un oggetto Virtual Machine Manager (VMM).

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

-Owner

Specifica il proprietario di un oggetto VMM sotto forma di account utente di dominio valido.

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-StartDate

Specifica la data di inizio di una finestra del servizio. Il valore predefinito è la data corrente. È possibile digitare una nuova data nel formato di data breve per le impostazioni locali oppure passare un oggetto DateTime da Get-Date.

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

-StartTimeOfDay

Specifica l'ora del giorno o un intervallo di tempo durante un periodo di 24 ore per avviare un processo o un'altra operazione. Il valore predefinito è l'ora corrente.

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

-TimeZone

Specifica un numero (indice) che identifica un'area geografica che condivide la stessa ora solare. Per un elenco degli indici di fuso orario, vedere Valori di indice del fuso orario Microsoft all'indirizzo http://go.microsoft.com/fwlink/?LinkId=120935. Se non viene specificato alcun fuso orario, il fuso orario predefinito usato per una macchina virtuale è la stessa impostazione del fuso orario presente nell'host della macchina virtuale.

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

-WeeklyScheduleDayOfWeek

Specifica uno o più giorni della settimana per l'esecuzione di un processo. Il valore predefinito è il giorno corrente della settimana.

  • Valori validi per specificare un singolo giorno usando una stringa: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica.
  • Valori validi per specificare un set di giorni in una settimana: qualsiasi set di due o più giorni separati da virgole.
  • Valori validi per specificare un singolo giorno usando un numero intero: 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

Specifica una settimana relativa al primo giorno del mese, ad esempio primo, secondo, terzo, quarto o ultimo.

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

Specifica la quantità di tempo, espressa in settimane, tra i processi pianificati. Il valore predefinito è il valore minimo di uno (1). Non è previsto alcun valore massimo.

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

Output

ServicingWindow

Questo cmdlet restituisce un oggetto ServicingWindow .