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 Configuration Manager cmdlet dall'unità del sito 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.
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationId
Specifica l'ID di un'applicazione.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationName
Specifica il nome di un'applicazione.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Specificare un oggetto raccolta in cui viene distribuita l'applicazione. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Specificare l'ID della raccolta in cui viene distribuita l'applicazione. Ad esempio, "SMS00004"
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specificare il nome della raccolta in cui viene distribuita l'applicazione.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
Specifica un commento facoltativo per la distribuzione.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateAlertBaseOnPercentSuccess
Indica se creare un avviso per una percentuale delle applicazioni distribuite correttamente. Per specificare il valore percentuale, usare il parametro SuccessParameterValue .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
Impostare questo parametro su $true
per abilitare la modalità di manutenzione di System Center Operations Manager per questa distribuzione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
Impostare questo parametro su $true
per abilitare l'imposizione ritardata.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 $True
CreatAlertBaseOnPercentFailure su .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specificare un oggetto di distribuzione dell'applicazione da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMApplicationDeployment .
Type: | IResultObject |
Aliases: | Application, DeploymentSummary, Assignment |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 esegue il commit in un secondo momento.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostponeDateTime
Quando si imposta CreateAlertBaseOnPercentSuccess$true
su , 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 .
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDeploy
Indica se eseguire la pre-distribuzione dell'applicazione nel dispositivo primario dell'utente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RaiseMomAlertsOnFailure
Indica se creare un avviso di Operations Manager se un client non riesce a installare l'applicazione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireApproval
Se si imposta questo parametro $true
su , un amministratore deve approvare una richiesta per questa applicazione nel dispositivo.
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Required: | False |
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 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
Specifica il fuso orario da usare:
LocalTime
: usare l'ora locale.UTC
: usa l'ora UTC (Coordinated Universal Time).
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica se consentire ai client di scaricare il contenuto tramite una connessione Internet a consumo dopo la scadenza, con costi aggiuntivi.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per