New-CMMaintenanceWindow
SYNOPSIS
Utwórz okno obsługi dla kolekcji.
SYNTAX
ByValue (wartość domyślna)
New-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] [-InputObject] <IResultObject> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-Name <String> -Schedule <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
ByCollectionId
New-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] [-CollectionId] <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>] -Name <String>
-Schedule <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByCollectionName
New-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] [-CollectionName] <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>] -Name <String>
-Schedule <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
To polecenie cmdlet umożliwia utworzenie okna obsługi dla kolekcji. Okna obsługi to cykliczne okresy, w których klient Menedżer konfiguracji może uruchamiać zadania. Można na przykład zastosować aktualizacje oprogramowania lub zainstalować oprogramowanie. To okno zapewnia, że istotne zmiany systemu zachodą tylko w czasie, który nie wpływa na produktywność i czas pracy.
Aby uzyskać więcej informacji na temat okien obsługi, zobacz Jak używać okien obsługi w programie Menedżer konfiguracji.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Tworzenie okna obsługi
Pierwsze polecenie używa polecenia cmdlet New-CMSchedule do utworzenia obiektu schedule, a następnie zapisuje go w $MWSchedule zmiennej .
Drugie polecenie tworzy okno obsługi o nazwie MonthlySchedule dla określonej kolekcji.
Okno obsługi używa harmonogramu przechowywanego w $MWSchedule zmiennej .
$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule
Przykład 2: Kopiowanie okna obsługi między kolekcjami
Pierwsze polecenie pobiera okno obsługi z kolekcji o identyfikatorze XYZ0003F. Następnie tworzy okno obsługi w kolekcji o identyfikatorze XYZ0005D o tej samej nazwie, tym samym harmonogramie i tylko dla aktualizacji oprogramowania.
$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly
PARAMETERS
-ApplyTo
Określ typ okna obsługi do utworzenia:
Any: okno obsługi ma zastosowanie do wszystkich wdrożeń.SoftwareUpdatesOnly: okno obsługi ma zastosowanie tylko do wdrożeń aktualizacji oprogramowania.TaskSequencesOnly: okno obsługi ma zastosowanie tylko do wdrożeń sekwencji zadań.
Jeśli ten parametr nie zostanie określony, Any parametr jest wartością domyślną.
Type: MaintenanceWindowApplyTo
Parameter Sets: (All)
Aliases:
Accepted values: Any, SoftwareUpdatesOnly, TaskSequencesOnly
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplyToSoftwareUpdateOnly
Ten parametr jest przestarzały. Użyj parametru ApplyTo z wartością SoftwareUpdatesOnly.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplyToTaskSequenceOnly
Ten parametr jest przestarzały. Użyj parametru ApplyTo z wartością TaskSequencesOnly.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Określ identyfikator kolekcji, aby dodać okno obsługi. Ten identyfikator jest standardowym identyfikatorem kolekcji, na przykład XYZ0003F .
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Określ nazwę kolekcji, aby dodać okno obsługi.
Type: String
Parameter Sets: ByCollectionName
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Dodaj ten parametr, aby monitować o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określ obiekt dla kolekcji, aby dodać okno obsługi. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: ByValue
Aliases: Collection, Site
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-IsEnabled
Aby utworzyć okno obsługi w kolekcji, ale nie ma ono aktywne, ustaw ten parametr na $false wartość . Jeśli nie uwzględnisz tego parametru, to polecenie cmdlet włącza okno obsługi.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsUtc
Aby skonfigurować harmonogram okna obsługi do używania Uniwersalny czas koordynowany (UTC), ustaw ten parametr na $true wartość . Jeśli ten parametr nie zostanie dołączyć, harmonogram użyje czasu lokalnego.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Określ nazwę okna obsługi.
Type: String
Parameter Sets: (All)
Aliases: MaintenanceWindowName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Schedule
Określ obiekt harmonogramu dla czasu wystąpienia okna obsługi. Aby uzyskać ten obiekt, użyj polecenia cmdlet New-CMSchedule.
Obiekt okna obsługi przechowuje harmonogram jako ciąg tokenu. Aby skopiować harmonogram z innego obiektu, użyj polecenia cmdlet Convert-CMSchedule. Na przykład Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_ServiceWindow
UWAGI
Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_ServiceWindow klasy WMI serwera.