New-CMApplicationDeployment
Creare una distribuzione dell'applicazione.
Sintassi
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-CMApplicationDeployment crea una distribuzione dell'applicazione. Per altre informazioni, vedere Distribuire applicazioni con Configuration Manager.
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: Installare un'applicazione
Questo comando crea una nuova distribuzione per Visual Studio 2019 nella raccolta Developers Workstation. Installa l'app ed è obbligatorio. Sia la data che la scadenza disponibili sono la stessa ora del passato, quindi non appena il client riceve questo criterio, installa l'app.
New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose RequiredParametri
-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 |
-ApprovalRequired
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 |
-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
Specificare un commento facoltativo per questa 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: | 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 |
| Alias: | SupersedenceDeadlineDateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeployAction
Specificare l'azione di distribuzione, per installare o disinstallare l'applicazione. Se le distribuzioni concorrenti hanno come destinazione lo stesso dispositivo, l'azione Installa ha la priorità.
| Tipo: | DeployActionType |
| Valori accettati: | Install, Uninstall |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeployPurpose
Specificare lo scopo della distribuzione:
Available: l'utente visualizza l'applicazione in Software Center. Possono installarlo su richiesta.Required: il client installa automaticamente l'app in base alla pianificazione impostata. Se l'applicazione non è nascosta, un utente può tenere traccia dello stato della distribuzione. Possono anche usare Software Center per installare l'applicazione prima della scadenza.
| Tipo: | DeployPurposeType |
| Valori accettati: | Available, Required |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DisableContentDependencyDetection
Aggiungere questo parametro per non distribuire automaticamente il contenuto per le app dipendenti.
| Tipo: | SwitchParameter |
| Alias: | DisableDetectAssociatedContentDependencies |
| 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 |
-DistributeCollectionName
Il sito distribuisce il contenuto ai punti di distribuzione associati al nome della raccolta.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DistributeContent
Aggiungere questo parametro se è necessario distribuire prima il contenuto dell'app.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DistributionPointGroupName
Per distribuire il contenuto dell'applicazione, specificare il nome di un gruppo di punti di distribuzione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DistributionPointName
Per distribuire il contenuto dell'applicazione, specificare il nome di un punto di distribuzione.
| Tipo: | String |
| 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 |
-GenerateScomAlertOnFailure
Indica se creare un avviso di Operations Manager se un client non riesce a installare l'applicazione.
| Tipo: | Boolean |
| Alias: | RaiseMomAlertsOnFailure |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Id
Specificare l'ID dell'applicazione da distribuire.
| Tipo: | Int32 |
| Alias: | CIId, CI_ID, ApplicationId |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Specificare un oggetto applicazione da distribuire. Per ottenere questo oggetto, usare il cmdlet Get-CMApplication .
| Tipo: | IResultObject |
| Alias: | Application |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Name
Specificare il nome dell'applicazione da distribuire.
| Tipo: | String |
| Alias: | LocalizedDisplayName, ApplicationName |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| 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 |
-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 |
-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 |
-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 |
-Simulation
Aggiungere questo parametro per creare una simulazione di distribuzione. Per altre informazioni, vedere Simulare distribuzioni di applicazioni con Configuration Manager.
| Tipo: | SwitchParameter |
| 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 |
-UpdateSupersedence
Per una distribuzione disponibile, usare questo parametro per specificare la scadenza dell'installazione per aggiornare gli utenti o i dispositivi in cui è installata l'applicazione sostituita. Usare DeadlineDateTime per specificare un'ora specifica, altrimenti è il più presto possibile dopo AvailableDateTime.
| Tipo: | Boolean |
| 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: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object