New-CMWindowsServicingPlan
SYNOPSIS
Skapar en Windows 10 serviceplan.
SYNTAX
NewByCollectionName
New-CMWindowsServicingPlan -Name <String> [-Description <String>] -CollectionName <String> [-Enable <Boolean>]
[-SendWakeupPacket <Boolean>] [-VerboseLevel <VerboseLevelType>] [-Language <String[]>] [-Required <String[]>]
[-Title <String[]>] [-RunType <RunType>] [-Schedule <IResultObject>] [-UseUtc <Boolean>]
[-AvailableTime <Int32>] [-AvailableImmediately <Boolean>] [-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>] [-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>] [-GenerateSuccessAlert <Boolean>] [-SuccessPercentage <Int32>]
[-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>] [-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>] [-DownloadFromInternet <Boolean>] [-Location <String>]
[-DeploymentRing <DeploymentRing>] [-UpdateDeploymentWaitDay <Int32>] [-LanguageSelection <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
NewByCollection
New-CMWindowsServicingPlan -Name <String> [-Description <String>] -Collection <IResultObject>
[-Enable <Boolean>] [-SendWakeupPacket <Boolean>] [-VerboseLevel <VerboseLevelType>] [-Language <String[]>]
[-Required <String[]>] [-Title <String[]>] [-RunType <RunType>] [-Schedule <IResultObject>]
[-UseUtc <Boolean>] [-AvailableTime <Int32>] [-AvailableImmediately <Boolean>]
[-AvailableTimeUnit <TimeUnitType>] [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>] [-UserNotification <UserNotificationType>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowRestart <Boolean>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-WriteFilterHandling <Boolean>]
[-GenerateSuccessAlert <Boolean>] [-SuccessPercentage <Int32>] [-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>] [-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>] [-DownloadFromInternet <Boolean>] [-Location <String>]
[-DeploymentRing <DeploymentRing>] [-UpdateDeploymentWaitDay <Int32>] [-LanguageSelection <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
NewByCollectionId
New-CMWindowsServicingPlan -Name <String> [-Description <String>] -CollectionId <String> [-Enable <Boolean>]
[-SendWakeupPacket <Boolean>] [-VerboseLevel <VerboseLevelType>] [-Language <String[]>] [-Required <String[]>]
[-Title <String[]>] [-RunType <RunType>] [-Schedule <IResultObject>] [-UseUtc <Boolean>]
[-AvailableTime <Int32>] [-AvailableImmediately <Boolean>] [-AvailableTimeUnit <TimeUnitType>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-UserNotification <UserNotificationType>] [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowRestart <Boolean>] [-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>]
[-WriteFilterHandling <Boolean>] [-GenerateSuccessAlert <Boolean>] [-SuccessPercentage <Int32>]
[-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>] [-DisableOperationManager <Boolean>]
[-GenerateOperationManagerAlert <Boolean>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
[-UseBranchCache <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-DeploymentPackage <IResultObject>] [-DownloadFromInternet <Boolean>] [-Location <String>]
[-DeploymentRing <DeploymentRing>] [-UpdateDeploymentWaitDay <Int32>] [-LanguageSelection <String[]>]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten New-CMWindowsServicingPlan skapar en Windows 10 serviceplan.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa en serviceplan efter samlings-ID
PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")
Det första kommandot skapar en lista över språk och lagrar listan i $Lang variabeln.
Det andra kommandot skapar en lista över söksträngar och lagrar listan i $Required variabeln. Den här söksträngen hittar programuppdateringar som krävs på minst en dator och högst 100 datorer.
Det tredje kommandot skapar en lista över programuppdateringstitlar och lagrar listan i $Title variabeln.
Det sista kommandot hämtar programuppdateringsdistributionspaketet SUDP01 och skapar sedan en Windows-serviceplan med namnet Test för målsamlingen med ID:t MP40001A. Kommandot lägger till uppgraderingsfilterspråken som lagras i $Lang, det nödvändiga filtret som lagras i $Required och rubrikfiltret för programuppdatering som lagras i $Title.
Exempel 2: Skapa en serviceplan efter samlingsnamn
PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect
Det första kommandot skapar en lista över språkvalsspråk och lagrar listan i $LangSelect variabeln.
Det andra kommandot hämtar programuppdateringsdistributionspaketet med namnet SUP02 och skapar sedan en Windows serviceplan med namnet Test02 för målsamlingen med namnet ColName02. Kommandot lägger till språket select-språk som lagras i $LangSelect.
PARAMETERS
-AlertTime
Anger en heltalsförskjutning från en tidsgräns för uppdateringsdistribution. Regeln använder det här värdet för att ange när regeln genererar aviseringar. Ange en tidsenhet med hjälp av parametern AlertTimeUnit.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AlertTimeUnit
Anger en tidsenhet för parametern AlertTime. Giltiga värden är:
- Tider
- Dagar
- Veckor
- Månader
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowRestart
Anger om en systemstart tillåts utföras utanför definierade underhållsfönster när tidsgränsen för installationen nås.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowSoftwareInstallationOutsideMaintenanceWindow
Anger om programinstallationen får utföras utanför definierade underhållsfönster när tidsgränsen för installationen har nåtts.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowUseMeteredNetwork
Anger om klienter ska kunna ladda ned innehåll via en avgiftsuppladdad Internetanslutning efter tidsgränsen, vilket kan medföra ytterligare kostnader.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableImmediately
Anger om programuppdateringar är tillgängliga för installation så snart som möjligt efter att regeln har körts.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableTime
Ange när programuppdateringar är tillgängliga.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableTimeUnit
Anger tidsenhetstyp för tillgänglig tid för programvara. Giltiga värden är:
- Tider
- Dagar
- Veckor
- Månader
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Samling
Anger målenhetssamlingsobjektet som ska användas för serviceplanen. Om du vill hämta ett enhetssamlingsobjekt använder du cmdletarna Get-CMCollection eller Get-CMDeviceCollection.
Type: IResultObject
Parameter Sets: NewByCollection
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Anger ID:t för målenhetssamlingen som ska användas för serviceplanen.
Type: String
Parameter Sets: NewByCollectionId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Anger namnet på målenhetssamlingen som ska användas för serviceplanen.
Type: String
Parameter Sets: NewByCollectionName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineImmediately
Anger om nödvändiga programuppdateringar installeras så snart som möjligt när tidsgränsen nås.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineTime
Anger antalet tidsenheter för tidsgränsen.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineTimeUnit
Anger tidsenhetstyp för tidsgränsen. Giltiga värden är:
- Tider
- Dagar
- Veckor
- Månader
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentPackage
Anger ett distributionspaket för programuppdatering. Om du vill hämta ett programuppdateringsdistributionspaket använder du cmdleten Get-CMSoftwareUpdateDeploymentPackage.
Type: IResultObject
Parameter Sets: (All)
Aliases: InputObject
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentRing
Anger Windows beredskapstillstånd som serviceplanen ska gälla för. Giltiga värden är:
- CB
- Frisläpp
- BusinessMainstream
- Cbb
- Ltsb
Type: DeploymentRing
Parameter Sets: (All)
Aliases:
Accepted values: CB, Release, BusinessMainstream, Cbb, Ltsb
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beskrivning
Anger en beskrivning av serviceplanen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableOperationManager
Anger om du vill inaktivera System Center Operations Manager aviseringar under programuppdateringar.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadFromInternet
Anger om programuppdateringar ska laddas ned från Internet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadFromMicrosoftUpdate
Anger om datorer laddar ned innehåll Microsoft Update om programuppdateringarna inte är tillgängliga på en prioriterad distributionsplats eller fjärrdistributionsplats.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Aktivera
Anger om serviceplanen är aktiverad.
Type: Boolean
Parameter Sets: (All)
Aliases: Enabled, EnableDeployment
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateOperationManagerAlert
Anger om du vill Operations Manager aviseringar under en programuppdatering.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateSuccessAlert
Anger om du vill generera en avisering för lyckad distribution.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Language
Anger en matris med språk som används för att filtrera programvaruuppgraderingar som ska läggas till i tjänstplanen.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LanguageSelection
Anger en matris med språk, som strängar. Datorer laddar ned programuppdateringar som är tillgängliga på de angivna språken, förutom icke-språkspecifika uppdateringar.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Plats
Anger en nätverksplats där de hämtade uppdateringarna finns.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Anger ett namn på serviceplanen. Namnet måste vara unikt, hjälpa till att beskriva syftet med regeln och identifiera det från andra på Konfigurationshanteraren webbplats.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnRemote
Anger om du vill tillåta installation av uppdateringar på fjärrsystem. Om du anger värdet $True, om klienten ligger inom en långsam eller otillförlitlig nätverksgräns, eller om klienten använder en återställningskälla för innehåll, installerar Konfigurationshanteraren inte programuppdateringar. Om du anger värdet $False fortsätter installationen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnUnprotected
Anger om du vill tillåta installation av uppdateringar på oskyddade system. Om du anger värdet $True programuppdateringar inte är tillgängliga på några prioriterade distributionsplatser, kommer Konfigurationshanteraren inte att hämta och installera programuppdateringar. Om du anger värdet $False fortsätter installationen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Krävs
Anger en matris med söksträngar som används för att filtrera programvaruuppgraderingar som ska läggas till i tjänstplanen.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunType
Anger i vilket läge en uppdatering körs. Giltiga värden är:
- DoNotRunThisRuleAutomatiskt
- RunTheRuleAfterAnySoftwareUpdatePointSynchronization
- RunTheRuleOnSchedule
Type: RunType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Schema
Anger tidsgränstiden (från tillgänglig distributionstid). Om du vill skapa ett schema använder du cmdleten New-CMSchedule.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Anger om ett aktiveringspaket ska skickas till datorer innan distributionen påbörjas. Om det här $True aktiveras Konfigurationshanteraren en dator från strömsparläge. Om det här $False aktiveras inte datorer från strömsparläge. För att datorer ska aktiveras måste du först konfigurera Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuccessPercentage
Anger en procentandel för klientefterlevnad som ett heltal från 0 till 99. Om kompatibiliteten understiger den här procentandelen Konfigurationshanteraren genererar valfria aviseringar.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuppressRestartServer
Anger om en systemstart ignoreras på servrar när en programuppdatering kräver en systemstart för att slutföra installationsprocessen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuppressRestartWorkstation
Anger om en systemstart ignoreras på arbetsstationer när en programuppdatering kräver en omstart av systemet för att slutföra installationsprocessen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Rubrik
Anger en matris med söksträngar som används för att filtrera programuppdateringstitlar som ska läggas till i tjänstplanen.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateDeploymentWaitDay
Anger hur många dagar som ska vänta efter att Microsoft har publicerat en ny uppgradering innan distributionen i din miljö.
Type: Int32
Parameter Sets: (All)
Aliases: UpdateDeploymentWaitDays
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseBranchCache
Anger om du vill använda en grencache. Om du anger värdet $True delar klienter innehåll i samma undernät.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtc
Anger om schemat för den här distributionen utvärderas baserat på UTC (Universal Coordinated Time).
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserNotification
Anger meddelandebeteendet för den visuella användarupplevelsen. Giltiga värden är:
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VerboseLevel
Anger den detaljnivå som du vill att klienterna ska rapportera för distributioner som skapas med den här regeln. Giltiga värden är:
- AllMessages
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
Type: VerboseLevelType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WriteFilterHandling
Anger om ändringar har gjorts inom tidsgränsen eller under en underhållsfönstret (kräver omstarter). Om det är $False tillämpas innehållet på överlägget och int anges senare.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.