Set-CMApplicationDeployment
Configurare una distribuzione dell'applicazione
Sintassi
Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
-InputObject <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationId <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationName <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet Set-CMApplicationDeployment modifica le proprietà di una distribuzione dell'applicazione in Configuration Manager. Per altre informazioni, vedere Distribuire applicazioni con Configuration Manager.
Per specificare una distribuzione dell'applicazione da modificare, specificare il nome della raccolta e l'applicazione. È possibile specificare un'applicazione in base al nome o all'ID. È anche possibile usare il cmdlet Get-CMApplication per ottenere un'applicazione da modificare.
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: Modificare la disponibilità e la scadenza per una distribuzione dell'applicazione
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)Questo comando modifica una distribuzione dell'applicazione per un'applicazione denominata Track System 2011 per una raccolta denominata All Users. Il comando specifica la data corrente per quando l'applicazione è disponibile. Configura anche la scadenza della distribuzione per 30 giorni in futuro.
Parametri
-AllowRepairApp
Usare questo parametro per configurare l'opzione di ripristino dell'applicazione durante la creazione di una distribuzione per un'applicazione.
| Tipo: | Boolean |
| Alias: | AllowUserRepairApplication |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ApplicationId
Specifica l'ID di un'applicazione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ApplicationName
Specifica il nome di un'applicazione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-AutoCloseExecutable
A partire dalla versione 2107, impostare questo parametro su per abilitare $true l'impostazione di distribuzione dell'applicazione per i comportamenti di installazione. Usare quindi il cmdlet Add-CMDeploymentTypeInstallBehavior per aggiungere un file eseguibile per verificare che l'installazione non venga eseguita correttamente.
Impostare questo parametro su $false per disabilitare questa opzione nelle situazioni seguenti:
- Quando si usa il cmdlet Remove-CMDeploymentTypeInstallBehavior per rimuovere tutti i file eseguibili
- Non si vuole che la distribuzione controlli la presenza di eseguibili in esecuzione.
| Tipo: | Boolean |
| Alias: | AutoCloseExeOnInstallBehavior |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-AvailableDateTime
Specificare un oggetto DateTime per quando questa distribuzione è disponibile. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .
Usare DeadlineDateTime per specificare l'assegnazione o la scadenza della distribuzione.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Collection
Specificare un oggetto raccolta in cui viene distribuita l'applicazione. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .
| Tipo: | IResultObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CollectionId
Specificare l'ID della raccolta in cui viene distribuita l'applicazione. Ad esempio, "SMS00004".
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CollectionName
Specificare il nome della raccolta in cui viene distribuita l'applicazione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-Comment
Specifica un commento facoltativo 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 |
-CreateAlertBaseOnPercentFailure
Indica se creare un avviso per una percentuale delle applicazioni che non vengono distribuite. Per specificare il valore percentuale, usare il parametro FailParameterValue .
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CreateAlertBaseOnPercentSuccess
Indica se creare un avviso per una percentuale delle applicazioni distribuite correttamente. Per specificare il valore percentuale, usare il parametro SuccessParameterValue .
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeadlineDateTime
Specificare un oggetto DateTime per quando viene assegnata questa distribuzione, nota anche come scadenza. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .
Utilizzare -AvailableDateTime per specificare quando la distribuzione è disponibile.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| 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 |
-EnableMomAlert
Impostare questo parametro su $true per abilitare la modalità di manutenzione di System Center Operations Manager per questa distribuzione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-EnableSoftDeadline
Impostare questo parametro su $true per abilitare l'imposizione ritardata.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FailParameterValue
Specifica la percentuale di installazione dell'applicazione non riuscita che causa un avviso.
Specificare un numero intero compreso tra 1 e 100.
Per abilitare questo avviso, impostare il parametro $TrueCreatAlertBaseOnPercentFailure su .
| Tipo: | Int32 |
| 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
Specificare un oggetto di distribuzione dell'applicazione da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMApplicationDeployment .
| Tipo: | IResultObject |
| Alias: | Application, DeploymentSummary, Assignment |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-OverrideServiceWindow
Indica se la distribuzione viene eseguita anche se pianificata 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, Configuration Manager distribuisce l'applicazione anche se l'ora pianificata non rientra nella finestra di manutenzione.
Se questo valore è $False, Configuration Manager non distribuisce l'applicazione all'esterno della finestra. Attende fino a quando non può essere distribuito in una finestra disponibile.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PassThru
Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare 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 |
-PostponeDateTime
Quando si imposta CreateAlertBaseOnPercentSuccess$truesu , utilizzare questo parametro per specificare un oggetto DateTime . Configuration Manager crea un avviso di distribuzione quando la soglia è inferiore a SuccessParameterValue dopo questa data.
Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PreDeploy
Indica se eseguire la pre-distribuzione dell'applicazione nel dispositivo primario dell'utente.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RaiseMomAlertsOnFailure
Indica se creare un avviso di Operations Manager se un client non riesce a installare l'applicazione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RebootOutsideServiceWindow
Indica se un computer 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 qualsiasi riavvio necessario 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 |
-ReplaceToastNotificationWithDialog
Quando il software necessario è disponibile nel client, impostare questo parametro $true su per sostituire le notifiche di tipo avviso popup predefinite con una finestra di dialogo. È false per impostazione predefinita. Per altre informazioni, vedere Sostituire le notifiche di tipo avviso popup con la finestra di dialogo.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RequireApproval
Se si imposta questo parametro $truesu , un amministratore deve approvare una richiesta per questa applicazione nel dispositivo.
| Tipo: | Boolean |
| Alias: | AppRequiresApproval |
| 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 tenta di riattivare 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 |
-SuccessParameterValue
Specifica la percentuale di installazione dell'applicazione riuscita che causa un avviso.
Specificare un numero intero compreso tra 0 e 99.
Per abilitare questo avviso, impostare il parametro CreateAlertBaseOnPercentSuccess su $True.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TimeBaseOn
Specifica il fuso orario da usare:
-
LocalTime: usare l'ora locale. -
UTC: usa l'ora UTC (Coordinated Universal Time).
| Tipo: | TimeType |
| Valori accettati: | LocalTime, Utc |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseMeteredNetwork
Indica se consentire ai client di scaricare il contenuto tramite una connessione Internet a consumo dopo la scadenza, con costi aggiuntivi.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UserNotification
Specifica il tipo di notifica utente.
-
DisplayAll: visualizza in Software Center e mostra tutte le notifiche. -
DisplaySoftwareCenterOnly: viene visualizzato in Software Center e vengono visualizzate solo le notifiche dei riavvii del computer. -
HideAll: nascondi in Software Center e tutte le notifiche.
| Tipo: | UserNotificationType |
| Valori accettati: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| 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
IResultObject
Note
Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_ApplicationAssignment classe WMI del server.