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 è possibile eseguire il lavoro di manutenzione 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 del fuso orario GMT Standard. 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 Gruppo di server di test 3 che si verifica ogni settimana il sabato a partire dalle 11:00 nel fuso orario orientale e dura 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 biweekly

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 Staging Group C che si verifica ogni altra settimana (biweekly) 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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DayOfMonth

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

Il valore predefinito è l'intero che corrisponde allo stesso giorno specificato nel parametro StartDate.

  • Valori interi validi: 1 - 31
  • Valori stringa validi: First, Last
Tipo:DayOfMonthType
Valori accettati: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
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per la finestra di manutenzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinutesDuration

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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ì è il valore predefinito). I valori accettabili per questo parametro sono:

  • Lunedì
  • Martedì
  • Mercoledì
  • Giovedì
  • Venerdì
  • Sabato
  • Domenica

Requisito: usare con il parametro WeekOfMonth .

Tipo:DayOfWeek
Valori accettati:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MonthsToRecur

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

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

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Owner

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StartDate

Specifica la data di avvio 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.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeZone

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VMMServer

Specifica un oggetto server VMM.

Tipo:ServerConnection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WeekOfMonth

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

Tipo:WeekOfMonthType
Valori accettati:First, Second, Third, Fourth, Last
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WeeksToRecur

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

ServicingWindow

Questo cmdlet restituisce un oggetto ServicingWindow.