Start-CMPackageDeployment

(Deprecato) Avvia la distribuzione di un pacchetto software in una raccolta di Configuration Manager.

Sintassi

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-Package] <IResultObject>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageName <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageId <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-Program] <IResultObject>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageName <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageId <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-Package] <IResultObject>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-PassThru]
     [-Program] <IResultObject>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Descrizione

Importante

Questo cmdlet è deprecato. Usa invece New-CMPackageDeployment.

Il cmdlet Start-CMPackageDeployment avvia la distribuzione di un pacchetto software specificato nei computer appartenenti a una raccolta di Configuration Manager. Puoi scegliere quando il pacchetto diventa disponibile e quando scade la distribuzione del pacchetto. Puoi specificare se Configuration Manager distribuisce il pacchetto una sola volta o più volte e cosa accade quando l'installazione non riesce per un computer.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Avviare una distribuzione ricorrente

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True

Questo comando avvia la distribuzione di un pacchetto denominato nella raccolta denominata All Systems per il programma per dispositivi denominato DPM. Il comando specifica un giorno di inizio e un'ora di inizio. Il comando include un commento descrittivo. Il parametro Rerun ha un valore di $True e il comando specifica un valore di ricorrenza pari a sette e un'unità di ricorrenza di Giorni, quindi la distribuzione viene eseguita di nuovo ogni sette giorni. La distribuzione usa la rete a consumo. La distribuzione utilizza l'ora UTC.

Esempio 2: Avviare una distribuzione ricorrente per un pacchetto disponibile

PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True

Questo comando avvia la distribuzione di un pacchetto denominato nella raccolta denominata Western Computers per il programma per dispositivi denominato DPM. Il comando include un commento descrittivo. Il comando specifica Available come DeployPurpose, in modo che gli utenti possano decidere se installare questo software. Il parametro Rerun ha un valore di $True. La distribuzione utilizza l'ora UTC.

Esempio 3: Avviare una distribuzione per un programma standard

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False

Questo comando avvia la distribuzione di un pacchetto denominato Strumento di migrazione stato utente per Windows 8 alla raccolta denominata All Systems per il programma standard denominato SPM. Il comando non consente ai computer di utilizzare contenuto condiviso.

Parametri

-AllowSharedContent

Indica se i client utilizzano contenuto condiviso. Se questo valore è $True, i client tentano di scaricare contenuto da altri client che hanno scaricato tale contenuto. Se questo valore è $False, i client non tentano di eseguire il download da altri client.

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

-CollectionName

Specifica l'ID di un dispositivo o di una raccolta utenti.

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

-Comment

Specifica un commento per la distribuzione.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableDateTime

Specifica, come oggetto DateTime, la data e l'ora in cui la distribuzione diventa disponibile. Per ottenere un oggetto DateTime, utilizzare il cmdlet Get-Date.

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

-DeploymentAvailableDay

Obsoleto. Utilizzare DeploymentAvailableDateTime.

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

-DeploymentAvailableTime

Obsoleto. Usa invece DeploymentAvailableDateTime.

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

-DeploymentExpireDateTime

Specifica, come oggetto DateTime, la data e l'ora di scadenza della distribuzione. Per ottenere un oggetto DateTime, utilizzare il cmdlet Get-Date.

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

-DeploymentExpireDay

Obsoleto. Usa invece DeploymentExpireDateTime.

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

-DeploymentExpireTime

Obsoleto. Utilizzare DeploymentExpireDateTime.

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

-DeploymentStartDateTime

Specifica, come oggetto DateTime, la data e l'ora di inizio della distribuzione. Per ottenere un oggetto DateTime, utilizzare il cmdlet Get-Date.

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

-DeploymentStartDay

Obsoleto. Utilizzare DeploymentStartDateTime.

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

-DeploymentStartTime

Obsoleto. Utilizzare DeploymentStartDateTime.

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

-DeployPurpose

Specifica lo scopo della distribuzione. I valori consentiti per questo parametro sono:

  • Disponibile
  • Obbligatorio
Type:DeployPurposeType
Accepted values:Available, Required
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceProgram

Specifica un programma per dispositivi.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-FastNetworkOption

Specifica il comportamento client in una rete veloce. I valori consentiti per questo parametro sono:

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Type:FastNetworkOptionType
Accepted values:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-Package

Specifica un oggetto pacchetto. Per ottenere un oggetto pacchetto, utilizzare il cmdlet Get-CMPackage.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PackageId

Specifica l'ID di un pacchetto.

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

-PackageName

Specifica il nome di un pacchetto.

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

-PassThru

Restituisce l'oggetto di lavoro corrente. Per impostazione predefinita, il cmdlet non genera alcun output.

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

-PersistOnWriteFilterDevice

Indica se abilitare i filtri di scrittura per i dispositivi incorporati. Per un valore di $True, il dispositivo esegue il commit delle modifiche durante una finestra di manutenzione. Questa azione richiede un riavvio. Per un valore di $False, il dispositivo salva le modifiche in una sovrimpressione e le salva in un secondo momento.

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

-Program

Specifica un programma.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProgramName

Specifica il nome di un programma.

Type:String
Aliases:StandardProgramName, DeviceProgramName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurUnit

Specifica un'unità per una distribuzione ricorrente. I valori consentiti per questo parametro sono:

  • Giorni
  • Ore
  • Minuti
Type:RecurUnitType
Accepted values:Minutes, Hours, Days
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurValue

Specifica la frequenza di ricorrenza di una distribuzione. Questo parametro dipende dal tipo di unità specificato nel parametro RecurUnit. Questo valore può essere compreso tra 1 e 23 se l'unità è Ore, tra 1 e 31 se l'unità è Giorni oppure tra 1 e 59 se l'unità è Minuti.

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

-Rerun

Indica se la distribuzione viene rieseguita. Se questo valore è $True, la distribuzione viene eseguita di nuovo per i client come specificato nel parametro RerunBehavior. Se questo valore è $False, la distribuzione non verrà eseguita di nuovo.

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

-RerunBehavior

Specifica la modalità di rieseguizione di una distribuzione in un client. I valori consentiti per questo parametro sono:

  • AlwaysRerunProgram. Eseguire di nuovo come pianificato, anche se la distribuzione ha avuto esito positivo. È possibile utilizzare questo valore per le distribuzioni ricorrenti.
  • NeverRerunDeployedProgram. Non viene rieseguita, anche se la distribuzione non è riuscita o se i file sono stati modificati.
  • RerunIfFailedPreviousAttempt. Eseguire di nuovo, come pianificato, se la distribuzione non è riuscita nel tentativo precedente.
  • RerunIfSucceededOnpreviousAttempt. Eseguire di nuovo solo se il tentativo precedente ha avuto esito positivo. È possibile utilizzare questo valore per gli aggiornamenti che dipendono dall'aggiornamento precedente.
Type:RerunBehaviorType
Accepted values:NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunFromSoftwareCenter

Indica se eseguire da Software Center.

Type:Boolean
Aliases:AllowUsersRunIndependently
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Specifica un oggetto schedule per la distribuzione.

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleEvent

Specifica una matrice di tipi di eventi di pianificazione. I valori consentiti per questo parametro sono:

  • AsSoonAsPossible
  • LogOff
  • LogOn
  • SendWakeUpPacket
Type:ScheduleEventType
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

Indica se inviare un pacchetto di riattivazione ai computer prima dell'inizio della distribuzione. Se questo valore è $True, Configuration Manager riattiva un computer dalla sospensione. Se questo valore è $False, non riattiva i computer dalla sospensione. Per la riattivazione dei computer, è necessario prima configurare riattivazione LAN.

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

-SlowNetworkOption

Specifica in che modo Configuration Manager distribuisce il pacchetto in una rete lenta. I valori consentiti per questo parametro sono:

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Type:SlowNetworkOptionType
Accepted values:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

Indica se installare il software distribuito al di fuori delle finestre di manutenzione. Una finestra di manutenzione è un periodo di tempo specificato utilizzato per la manutenzione e gli aggiornamenti del computer. Se questo valore è $True, Configuration Manager installa il software in base alla pianificazione, anche se la pianificazione non rientra in una finestra di manutenzione. Se questo valore è $False, Configuration Manager non installa il software distribuito all'esterno di alcuna finestra, ma attende una finestra di manutenzione.

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

-StandardProgram

Indica che il tipo di programma nel pacchetto di distribuzione è un programma standard.

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

-SystemRestart

Indica se un sistema viene riavviato al di fuori di una finestra di manutenzione. Una finestra di manutenzione è un periodo di tempo specificato utilizzato per la manutenzione e gli aggiornamenti del computer. Se questo valore è $True, qualsiasi riavvio necessario viene fatto indipendentemente dalle finestre di manutenzione. Se questo valore è $False, il computer non viene riavviato al di fuori di una finestra di manutenzione.

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

-UseMeteredNetwork

Indica se consentire ai client di scaricare contenuto su una connessione Internet a consumo dopo la scadenza, con costi aggiuntivi.

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

-UseUtc

Indica se utilizzare l'ora UTC (Coordinated Universal Time), nota anche come ora di Greenwich. Se questo valore è $True, Configuration Manager usa UTC per questa distribuzione. Se questo valore è $False, Configuration Manager usa l'ora locale.

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

-UseUtcForAvailableSchedule

Indica se utilizzare UTC per la pianificazione disponibile. Se questo valore è $True, Configuration Manager usa UTC. Se questo valore è $False, Configuration Manager usa l'ora locale.

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

-UseUtcForExpireSchedule

Indica se utilizzare UTC per la pianificazione della scadenza. Se questo valore è $True, Configuration Manager usa UTC. Se questo valore è $False, Configuration Manager usa l'ora locale.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object