Start-CMSoftwareUpdateDeployment

SYNOPSIS

(Inaktuell) Initierar en programuppdateringsdistribution i Konfigurationshanteraren.

SYNTAX

DeploySoftwareUpdateByValue (standard)

Start-CMSoftwareUpdateDeployment [-AcceptEula] [-AllowRestart <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 -CollectionName <String> [-DeploymentAvailableDay <DateTime>] [-DeploymentAvailableTime <DateTime>]
 [-DeploymentName <String>] [-DeploymentType <DeploymentType>] [-Description <String>]
 [-DisableOperationsManagerAlert <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>]
 [-EnforcementDeadline <DateTime>] [-EnforcementDeadlineDay <DateTime>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] -InputObject <IResultObject>
 [-PercentSuccess <Int32>] [-PersistOnWriteFilterDevice <Boolean>] [-ProtectedType <ProtectedType>]
 [-RestartServer <Boolean>] [-RestartWorkstation <Boolean>] [-SendWakeupPacket <Boolean>]
 [-SoftwareInstallation <Boolean>] [-TimeBasedOn <TimeType>] [-TimeUnit <TimeUnitType>] [-TimeValue <Int32>]
 [-UnprotectedType <UnprotectedType>] [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationType>]
 [-VerbosityLevel <VerbosityLevelType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DeploySoftwareUpdateByName

Start-CMSoftwareUpdateDeployment [-AcceptEula] [-AllowRestart <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 -CollectionName <String> [-DeploymentAvailableDay <DateTime>] [-DeploymentAvailableTime <DateTime>]
 [-DeploymentName <String>] [-DeploymentType <DeploymentType>] [-Description <String>]
 [-DisableOperationsManagerAlert <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>]
 [-EnforcementDeadline <DateTime>] [-EnforcementDeadlineDay <DateTime>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-ProtectedType <ProtectedType>] [-RestartServer <Boolean>]
 [-RestartWorkstation <Boolean>] [-SendWakeupPacket <Boolean>] [-SoftwareInstallation <Boolean>]
 -SoftwareUpdateName <String> [-TimeBasedOn <TimeType>] [-TimeUnit <TimeUnitType>] [-TimeValue <Int32>]
 [-UnprotectedType <UnprotectedType>] [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationType>]
 [-VerbosityLevel <VerbosityLevelType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DeploySoftwareUpdateById

Start-CMSoftwareUpdateDeployment [-AcceptEula] [-AllowRestart <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 -CollectionName <String> [-DeploymentAvailableDay <DateTime>] [-DeploymentAvailableTime <DateTime>]
 [-DeploymentName <String>] [-DeploymentType <DeploymentType>] [-Description <String>]
 [-DisableOperationsManagerAlert <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>]
 [-EnforcementDeadline <DateTime>] [-EnforcementDeadlineDay <DateTime>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-ProtectedType <ProtectedType>] [-RestartServer <Boolean>]
 [-RestartWorkstation <Boolean>] [-SendWakeupPacket <Boolean>] [-SoftwareInstallation <Boolean>]
 -SoftwareUpdateId <String> [-TimeBasedOn <TimeType>] [-TimeUnit <TimeUnitType>] [-TimeValue <Int32>]
 [-UnprotectedType <UnprotectedType>] [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationType>]
 [-VerbosityLevel <VerbosityLevelType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DeploySoftwareUpdateGroupByName

Start-CMSoftwareUpdateDeployment [-AcceptEula] [-AllowRestart <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 -CollectionName <String> [-DeploymentAvailableDay <DateTime>] [-DeploymentAvailableTime <DateTime>]
 [-DeploymentName <String>] [-DeploymentType <DeploymentType>] [-Description <String>]
 [-DisableOperationsManagerAlert <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>]
 [-EnforcementDeadline <DateTime>] [-EnforcementDeadlineDay <DateTime>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-ProtectedType <ProtectedType>] [-RestartServer <Boolean>]
 [-RestartWorkstation <Boolean>] [-SendWakeupPacket <Boolean>] [-SoftwareInstallation <Boolean>]
 -SoftwareUpdateGroupName <String> [-TimeBasedOn <TimeType>] [-TimeUnit <TimeUnitType>] [-TimeValue <Int32>]
 [-UnprotectedType <UnprotectedType>] [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationType>]
 [-VerbosityLevel <VerbosityLevelType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DeploySoftwareUpdateGroupById

Start-CMSoftwareUpdateDeployment [-AcceptEula] [-AllowRestart <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 -CollectionName <String> [-DeploymentAvailableDay <DateTime>] [-DeploymentAvailableTime <DateTime>]
 [-DeploymentName <String>] [-DeploymentType <DeploymentType>] [-Description <String>]
 [-DisableOperationsManagerAlert <Boolean>] [-DownloadFromMicrosoftUpdate <Boolean>]
 [-EnforcementDeadline <DateTime>] [-EnforcementDeadlineDay <DateTime>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-ProtectedType <ProtectedType>] [-RestartServer <Boolean>]
 [-RestartWorkstation <Boolean>] [-SendWakeupPacket <Boolean>] [-SoftwareInstallation <Boolean>]
 -SoftwareUpdateGroupId <String> [-TimeBasedOn <TimeType>] [-TimeUnit <TimeUnitType>] [-TimeValue <Int32>]
 [-UnprotectedType <UnprotectedType>] [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationType>]
 [-VerbosityLevel <VerbosityLevelType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Viktigt

Den här cmdleten är inaktuell. Använd New-CMSoftwareUpdateDeployment i stället.

Cmdleten Start-CMSoftwareUpdateDeployment initierar en programuppdateringsdistribution.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Starta en obligatorisk distribution med namnet på programuppdateringen

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test" -Description "Contoso-test-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Det här kommandot startar en obligatorisk programuppdateringsdistribution med hjälp av ett programuppdateringsnamn.

Exempel 2: Starta en tillgänglig distribution efter programuppdateringsnamn

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test2" -Description "Contoso-test2-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Det här kommandot startar en tillgänglig programuppdateringsdistribution med hjälp av ett programuppdateringsnamn.

Exempel 3: Starta en obligatorisk distribution med programuppdateringsgruppens namn

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test3" -Description "Contoso-test3-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Det här kommandot startar en programuppdateringsdistribution med hjälp av ett samlingsnamn och ett indataobjekt.

Exempel 4: Starta en distribution efter programuppdateringsgruppens namn

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test4" -Description "Contoso-test4-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Det här kommandot startar en programuppdateringsdistribution med hjälp av ett programuppdateringsgruppnamn.

PARAMETERS

-AcceptEula

Vissa programuppdateringar innehåller licensvillkor. Licensvillkoren visas inte när du distribuerar programuppdateringar. Lägg till den här parametern för att automatiskt distribuera alla programuppdateringar oavsett en associerad licensperiod.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowRestart

Anger om en omstart ska tillåtas efter installationen.

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 använda ett nätverk med dataförbrukning för att ladda ned uppdateringar.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Anger ett namn på en samling i Konfigurationshanteraren. En samling är en grupp med klientdatorer.

Type: String
Parameter Sets: (All)
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

-DeploymentAvailableDay

Anger en dag i FORMATET MM/DD/YYYY när en programuppdateringsdistribution är tillgänglig. Som standard är uppdateringen tillgänglig omedelbart.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentAvailableTime

Anger en tid i HH:MM-format när en programuppdateringsdistribution är tillgänglig. Som standard är uppdateringen tillgänglig omedelbart.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentName

Anger ett namn för en programuppdateringsdistribution i Konfigurationshanteraren.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentType

Anger en distributionstyp i Konfigurationshanteraren.

Type: DeploymentType
Parameter Sets: (All)
Aliases:
Accepted values: Required, Available

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Beskrivning

Anger en beskrivning för en programuppdateringsdistribution.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableOperationsManagerAlert

Anger om du vill inaktivera System Center 2012 – 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

-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

-DownloadFromMicrosoftUpdate

Anger om klienter laddar ned uppdateringar direkt från Microsoft Update.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnforcementDeadline

Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireTime

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnforcementDeadlineDay

Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDay

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 du vill Operations Manager aviseringar när en programinstallation misslyckas.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GenerateSuccessAlert

Anger om aviseringar ska genereras när en programinstallation lyckas.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Type: IResultObject
Parameter Sets: DeploySoftwareUpdateByValue
Aliases: SoftwareUpdate, SoftwareUpdateGroup

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-PercentSuccess

Anger en procentandel lyckade.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PersistOnWriteFilterDevice

Anger om du vill installera en programuppdatering på det tillfälliga överlägget och genomföra ändringar senare, eller genomföra ändringarna vid en tidsgräns för installation eller en underhållsfönstret.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProtectedType

Anger en skyddad typ.

Type: ProtectedType
Parameter Sets: (All)
Aliases:
Accepted values: NoInstall, RemoteDistributionPoint

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RestartServer

Anger om en server ska tillåtas att starta om efter en programuppdatering. Om du anger värdet $True förhindrar att servern startas om. Om du anger värdet $False kan servern starta om.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RestartWorkstation

Anger om du vill tillåta att en arbetsstation startas om efter en programuppdatering. Om du anger värdet till $True förhindrar att datorn startas om. Om du anger värdet till $False datorn att starta om.

Type: Boolean
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

-SoftwareInstallation

Anger om du vill tillåta att programuppdateringen installeras, även om installationen sker utanför en underhållsfönstret.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdateGroupId

Anger ett ID för en programuppdateringsgrupp. En programuppdateringsgrupp innehåller enskilda programuppdateringar.

Type: String
Parameter Sets: DeploySoftwareUpdateGroupById
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdateGroupName

Anger ett namn för en programuppdateringsgrupp.

Type: String
Parameter Sets: DeploySoftwareUpdateGroupByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdateId

Anger ett ID för en programuppdatering i Konfigurationshanteraren.

Type: String
Parameter Sets: DeploySoftwareUpdateById
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdateName

Anger ett namn för en programuppdatering i Konfigurationshanteraren.

Type: String
Parameter Sets: DeploySoftwareUpdateByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TimeBasedOn

Anger att klientdatorer använder antingen lokal tid eller UTC-tid för att fastställa tillgängligheten för ett program. UTC-tid gör programuppdateringen tillgänglig på samma gång för alla datorer.

Type: TimeType
Parameter Sets: (All)
Aliases:
Accepted values: LocalTime, Utc

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TimeUnit

Anger tidsenheten i Konfigurationshanteraren. Giltiga värden är:

• Dagar
• Tider
• Månader
• Veckor

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

-TimeValue

Anger ett tidsvärde i de enheter som anges i parametern TimeUnit.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UnprotectedType

Anger en oskyddad typ.

Type: UnprotectedType
Parameter Sets: (All)
Aliases:
Accepted values: NoInstall, UnprotectedDistributionPoint

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseBranchCache

Anger om branchcache ska användas som distributionsplats för uppdateringar.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserNotification

Anger en meddelandetyp för användaren.

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

-VerbosityLevel

Anger verbositetsnivå. Giltiga värden är:

• AllMessages
• OnlyErrorMessages
• OnlySuccessAndErrorMessages

Type: VerbosityLevelType
Parameter Sets: (All)
Aliases:
Accepted values: AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages

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

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

System.Object

ANTECKNINGAR

RELATED LINKS

Get-CMSoftwareUpdate

Get-CMSoftwareUpdateGroup

Set-CMSoftwareUpdateDeployment