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.

Get-CMMaintenanceWindow

Remove-CMMaintenanceWindow

Set-CMMaintenanceWindow

Convert-CMSchedule New-CMSchedule

Jak używać okien obsługi w programie Menedżer konfiguracji

Last updated on 2021-08-11

Udostępnij przez