New-CMAutoDeploymentRuleDeployment
SYNOPSIS
Skapa en distribution för en regel för automatisk distribution.
SYNTAX
ByName (standard)
New-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-Name] <String>
[-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>] [-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>] [-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ById
New-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-Id] <Int32>
[-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>] [-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>] [-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
ByValue
New-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>] [-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>] [-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>] [-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Cmdleten New-CMAutoDeploymentRuleDeployment skapar en distribution för en automatisk distributionsregel (ADR).
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 distribution för en regel för automatisk distribution efter namn
Det här kommandot skapar en distribution för regeln för automatisk distribution TestDepRule01 och samlingen Alla system.
New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
Exempel 2: Skapa en distribution för en regel för automatisk distribution per objekt
Det här kommandot hämtar regelobjektet för automatisk distribution med namnet TestDepRule02. Den använder sedan pipelineoperatorn för att skicka objektet till New-CMAutoDeploymentRuleDeployment, vilket skapar en distribution för regeln för automatisk distribution TestDepRule02 och samlingen Alla system.
Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
PARAMETERS
-AlertTime
Anger antalet tidsenheter för förskjutningen från tidsgränsen.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AlertTimeUnit
Anger tidsenhetstyp för förskjutningen från tidsgränsen.
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
-AllowDownloadFromMicrosoftUpdate
Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Ladda ned Inställningar i distributionsinställningarna för den automatiska distributionsregeln: Om programuppdateringar inte är tillgängliga på distributionsplatsen i aktuella grupper, granngrupper eller platsgränsgrupper laddar du ned innehåll från Microsoft Updates .
Type: Boolean
Parameter Sets: (All)
Aliases:
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
Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Ladda ned Inställningar i distributionsinställningarna för automatisk distributionsdistribution: Tillåt klienter med en Internetanslutning med dataförbrukning att ladda ned innehåll efter installationens tidsgräns, 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
Anger antalet tidsenheter för programvarans tillgängliga tid.
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.
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 ett målsamlingsobjekt för programuppdateringsdistributionen. Om du vill hämta ett samlingsobjekt använder du cmdleten Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Anger ID för målsamlingen för programuppdateringsdistributionen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Anger namnet på målsamlingen för programuppdateringsdistributionen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
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.
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
-DisableOperationsManager
Anger om Operations Manager är inaktiverade när programuppdateringar körs.
Type: Boolean
Parameter Sets: (All)
Aliases: DisableOperationManager
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableDeployment
Anger om distributionen ska aktiveras efter att den här regeln har körs för den associerade programvarugruppen. Om det är $False inställt på distribuerar du programuppdateringsgruppen manuellt.
Type: Boolean
Parameter Sets: (All)
Aliases: Enable, EnabledAfterCreate, EnableAfterCreate
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateOperationsManagerAlert
Anger om Operations Manager genereras när en programuppdateringsinstallation misslyckas.
Type: Boolean
Parameter Sets: (All)
Aliases: GenerateOperationManagerAlert
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateSuccessAlert
Anger om en avisering genereras när den här regeln körs korrekt.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Anger ID för den regel för automatisk distribution som distributionen ska läggas till i.
Type: Int32
Parameter Sets: ById
Aliases: AutoDeploymentID
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Anger ett regelobjekt för automatisk distribution som distributionen ska läggas till i. Om du vill hämta ett regelobjekt för automatisk distribution använder du cmdleten Get-CMSoftwareUpdateAutoDeploymentRule.
Type: IResultObject
Parameter Sets: ByValue
Aliases: AutoDeploymentRule
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Anger namnet på den regel för automatisk distribution som distributionen ska läggas till i.
Type: String
Parameter Sets: ByName
Aliases: AutoDeploymentName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnRemote
Anger om programuppdateringar ska installeras när uppdateringarna inte är tillgängliga på några fjärrdistributionsplatser.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnUnprotected
Anger om programuppdateringar ska installeras när uppdateringarna inte är tillgängliga på oskyddade distributionsplatser.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequirePostRebootFullScan
Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Användarupplevelse i distributionsinställningarna för den automatiska distributionsregeln: Om en uppdatering i den här distributionen kräver en omstart av systemet kör du utvärderingscykeln för uppdateringsdistribution efter omstart.
Type: Boolean
Parameter Sets: (All)
Aliases: RunEvaluationAfterRestart
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Anger om wake-on-LAN ska användas för att väcka klienter för nödvändiga distributioner.
Type: Boolean
Parameter Sets: (All)
Aliases: EnableWakeOnLan
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftDeadlineEnabled
Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Distributionsschema för distributionsinställningarna för automatisk distributions: Fördröj tvingande av den här distributionen enligt användarinställningar fram till respitperioden som definieras i klientinställningarna.
Type: Boolean
Parameter Sets: (All)
Aliases: DelayEnforcementAndUpToGracePeriod
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuccessPercentage
Anger procent som ett heltal för klientefterlevnad. När klientefterlevnaden understiger den här procentandelen genereras en avisering.
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 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
-SuppressRestartWorkstation
Anger om en systemstart ignoreras på arbetsstationer när en programuppdatering kräver en systemstart för att slutföra installationen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseBranchCache
Anger om klienter tillåts att dela innehåll med andra klienter 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.
Type: UserNotificationOption
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 hur mycket tillstånd som klienterna rapporterar tillbaka för distributioner som skapats av den här regeln.
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 inställt på tillämpas innehåll 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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_AdrDeploymentSettings
ANTECKNINGAR
RELATED LINKS
Get-CMAutoDeploymentRuleDeployment