Set-CMPackageDeployment
Modifica i valori che definiscono il modo in cui Configuration Manager distribuisce un pacchetto software.
Sintassi
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-InputObject <IResultObject>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageName <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageId <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageId <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-InputObject <IResultObject>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet Set-CMPackageDeployment modifica i valori che definiscono il modo in cui Configuration Manager distribuisce un pacchetto software. Una distribuzione include una raccolta di dispositivi o utenti, un pacchetto da distribuire e un nome di programma del dispositivo o un nome di programma standard. Per specificare la distribuzione da modificare, specificare il nome della raccolta, il pacchetto e il nome del programma. È possibile specificare il pacchetto in base al nome o all'ID oppure usare il cmdlet Get-CMPackage per ottenere un oggetto pacchetto.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.
Esempio
Esempio 1: Impostare le proprietà di ricorrenza
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $TrueQuesto comando apporta modifiche alla distribuzione specificata dalla raccolta denominata Tutti i sistemi, il programma per dispositivi denominato DPM e il pacchetto denominato User State Migration Tool per Windows 8. Il comando imposta il parametro UseRecurrencePattern su un valore di $True. Il comando specifica un'unità di ricorrenza di Ore e un valore di ricorrenza pari a sette. Di conseguenza, la distribuzione si ripete ogni sette ore.
Esempio 2: Impostare il giorno e l'ora di disponibilità
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $FalseQuesto comando apporta modifiche alla distribuzione specificata dalla raccolta denominata All Systems, il pacchetto denominato User State Migration Tool per Windows 8 e il programma standard denominato SPM. Il comando specifica un giorno e un'ora in cui la distribuzione diventa disponibile. Il comando specifica inoltre che la distribuzione non usa l'ora UTC per la pianificazione della disponibilità. La pianificazione fa riferimento al fuso orario locale.
Parametri
-AllowFallback
{{ Fill AllowFallback Description }}
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-AllowSharedContent
Indica se i client usano contenuto condiviso. Se questo valore è $True, i client tentano di scaricare il contenuto da altri client che hanno scaricato il contenuto. Se questo valore è $False, i client non tentano di scaricare da altri client.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Collection
Specifica la raccolta di utenti.
| Tipo: | IResultObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CollectionId
Specifica l'ID di un dispositivo o di una raccolta di utenti.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CollectionName
Specifica l'ID di un dispositivo o di una raccolta di utenti.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-Comment
Specifica un commento per la distribuzione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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 .
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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 .
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeviceProgramName
Specifica il nome di un programma per dispositivi.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-EnableExpireSchedule
Indica se abilitare la pianificazione per scadere la distribuzione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FastNetworkOption
Specifica il comportamento client in una rete veloce. I valori consentiti per questo parametro sono:
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
| Tipo: | FastNetworkOptionType |
| Valori accettati: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Specifica un oggetto pacchetto.
| Tipo: | IResultObject |
| Alias: | Package, DeploymentSummary, Advertisement |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-PackageId
Specifica l'ID di un pacchetto.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PackageName
Specifica il nome di un pacchetto.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PassThru
Restituisce l'oggetto di lavoro corrente. Per impostazione predefinita, il cmdlet non genera alcun output.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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 esegue il commit in un secondo momento.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RecurUnit
Specifica un'unità per una distribuzione ricorrente. I valori consentiti per questo parametro sono:
- Giorni
- Ore
- Minuti
| Tipo: | RecurUnitType |
| Valori accettati: | Minutes, Hours, Days |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RecurValue
Specifica la frequenza con cui si ripete 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 o tra 1 e 59 se l'unità è Minuti.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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 viene più eseguita.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RerunBehavior
Specifica la modalità di esecuzione di una distribuzione in un client. I valori consentiti per questo parametro sono:
- AlwaysRerunProgram. Eseguire di nuovo come pianificato, anche se la distribuzione è riuscita. È possibile usare questo valore per le distribuzioni ricorrenti.
- NeverRerunDeployedProgram. Non viene eseguita nuovamente, anche se la distribuzione non è riuscita o 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 usare questo valore per gli aggiornamenti che dipendono dall'aggiornamento precedente.
| Tipo: | RerunBehaviorType |
| Valori accettati: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RunFromSoftwareCenter
Indica se eseguire da Software Center.
| Tipo: | Boolean |
| Alias: | AllowUsersRunIndependently |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Schedule
Specifica un oggetto CMSchedule . La pianificazione specifica quando si verifica la finestra di manutenzione. Per creare un oggetto CMSchedule , usare il cmdlet New-CMSchedule .
| Tipo: | IResultObject[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ScheduleEvent
Specifica una matrice di tipi di evento di pianificazione. I valori consentiti per questo parametro sono:
- AsSoonAsPossible
- Disconnessione
- LogOn
- SendWakeUpPacket
| Tipo: | ScheduleEventType[] |
| Valori accettati: | AsSoonAsPossible, LogOn, LogOff |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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 consentire la riattivazione dei computer, è prima necessario configurare la lan di riattivazione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SlowNetworkOption
Specifica il modo in cui Configuration Manager distribuisce questo pacchetto in una rete lenta. I valori consentiti per questo parametro sono:
- DoNotRunProgram
- DownloadContentFromDistributionPointAndLocally
- RunProgramFromDistributionPoint
| Tipo: | SlowNetworkOptionType |
| Valori accettati: | DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SoftwareInstallation
Indica se installare il software distribuito all'esterno delle finestre di manutenzione. Una finestra di manutenzione è un periodo di tempo specificato usato 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.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-StandardProgramName
Specifica un nome di programma standard.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SystemRestart
Indica se un sistema viene riavviato all'esterno di una finestra di manutenzione. Una finestra di manutenzione è un periodo di tempo specificato usato per la manutenzione e gli aggiornamenti del computer. Se questo valore è $True, viene eseguito un riavvio obbligatorio senza considerare le finestre di manutenzione. Se questo valore è $False, il computer non viene riavviato all'esterno di una finestra di manutenzione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseRecurrencePattern
Indica se utilizzare un modello di ricorrenza.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseUtc
Indica se utilizzare l'ora UTC (Coordinated Universal Time), nota anche come Ora media di Greenwich. Se questo valore è $True, Configuration Manager usa l'ora UTC per questa distribuzione. Se questo valore è $False, Configuration Manager usa l'ora locale.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseUtcForAvailableSchedule
Indica se usare l'ora UTC per la pianificazione disponibile. Se questo valore è $True, Configuration Manager usa l'ora UTC. Se questo valore è $False, Configuration Manager usa l'ora locale.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseUtcForExpireSchedule
Indica se usare UTC per la pianificazione della scadenza. Se questo valore è $True, Configuration Manager usa l'ora UTC. Se questo valore è $False, Configuration Manager usa l'ora locale.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object