New-CMAutoDeploymentRuleDeployment
Creare una distribuzione per una regola di distribuzione automatica.
Sintassi
New-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Name] <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet New-CMAutoDeploymentRuleDeployment crea una distribuzione per una regola di distribuzione automatica (ADR).
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: Creare una distribuzione per una regola di distribuzione automatica in base al nome
Questo comando crea una distribuzione per la regola di distribuzione automatica TestDepRule01 e l'insieme All Systems.
New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
Esempio 2: Creare una distribuzione per una regola di distribuzione automatica in base all'oggetto
Questo comando ottiene l'oggetto regola di distribuzione automatica denominato TestDepRule02. Viene quindi utilizzato l'operatore della pipeline per passare l'oggetto a New-CMAutoDeploymentRuleDeployment, che crea una distribuzione per la regola di distribuzione automatica TestDepRule02 e l'insieme All Systems.
Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false
Parametri
-AlertTime
Specifica il numero di unità di tempo per la distanza dalla scadenza.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTimeUnit
Specifica il tipo di unità di tempo per l'offset dalla scadenza.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowDownloadFromMicrosoftUpdate
Utilizzare questo parametro per impostare l'opzione seguente nella pagina Scarica Impostazioni delle impostazioni di distribuzione ADR: se gli aggiornamenti software non sono disponibili nel punto di distribuzione nei gruppi di limiti correnti, vicini o del sito, scaricare il contenuto da Microsoft Updates.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRestart
Indica se è consentito eseguire un riavvio del sistema al di fuori di qualsiasi finestra di manutenzione definita quando viene raggiunta la scadenza dell'installazione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
Indica se l'installazione del software può essere eseguita al di fuori di qualsiasi finestra di manutenzione definita quando viene raggiunta la scadenza dell'installazione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUseMeteredNetwork
Utilizzare questo parametro per impostare l'opzione seguente nella pagina Scarica Impostazioni delle impostazioni di distribuzione ADR: Consentire ai client con una connessione Internet a consumo di scaricare contenuto dopo la scadenza dell'installazione, con costi aggiuntivi ****
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableImmediately
Indica se gli aggiornamenti software sono disponibili per l'installazione il prima possibile dopo l'esecuzione della regola.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTime
Specifica il numero di unità di tempo per il tempo disponibile per il software.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTimeUnit
Specifica il tipo di unità di tempo per il tempo disponibile software.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Specifica un oggetto insieme di destinazione per la distribuzione degli aggiornamenti software. Per ottenere un oggetto insieme, utilizzare il cmdlet Get-CMCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Specifica l'ID della raccolta di destinazione per la distribuzione dell'aggiornamento software.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specifica il nome della raccolta di destinazione per la distribuzione dell'aggiornamento software.
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 |
-DeadlineImmediately
Indica se gli aggiornamenti software necessari vengono installati il prima possibile quando viene raggiunta la scadenza.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTime
Specifica il numero di unità di tempo per la scadenza.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTimeUnit
Specifica il tipo di unità di tempo per la scadenza.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableOperationsManager
Indica se gli avvisi di Operations Manager sono disabilitati durante l'esecuzione degli aggiornamenti software.
Type: | Boolean |
Aliases: | DisableOperationManager |
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 |
-EnableDeployment
Indica se abilitare la distribuzione dopo l'esecuzione di questa regola per il gruppo software associato. Se impostato su $False
, distribuire manualmente il gruppo di aggiornamento software.
Type: | Boolean |
Aliases: | Enable, EnabledAfterCreate, EnableAfterCreate |
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 |
-GenerateOperationsManagerAlert
Indica se gli avvisi di Operations Manager vengono generati quando l'installazione di un aggiornamento software ha esito negativo.
Type: | Boolean |
Aliases: | GenerateOperationManagerAlert |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateSuccessAlert
Indica se viene generato un avviso quando questa regola viene eseguita correttamente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Specifica l'ID della regola di distribuzione automatica a cui aggiungere la distribuzione.
Type: | Int32 |
Aliases: | AutoDeploymentID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica un oggetto regola di distribuzione automatica a cui aggiungere la distribuzione. Per ottenere un oggetto regola di distribuzione automatica, utilizzare il cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.
Type: | IResultObject |
Aliases: | AutoDeploymentRule |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifica il nome della regola di distribuzione automatica a cui aggiungere la distribuzione.
Type: | String |
Aliases: | AutoDeploymentName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnRemote
Indica se installare gli aggiornamenti software quando gli aggiornamenti non sono disponibili in alcun punto di distribuzione remoto.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoInstallOnUnprotected
Indica se installare gli aggiornamenti software quando gli aggiornamenti non sono disponibili in alcun punto di distribuzione non protetto.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequirePostRebootFullScan
Utilizzare questo parametro per impostare **** l'opzione seguente nella pagina Esperienza utente delle impostazioni di distribuzione DI ADR: se un aggiornamento di questa distribuzione richiede il riavvio del sistema, eseguire il ciclo di valutazione della distribuzione degli aggiornamenti dopo il riavvio.
Type: | Boolean |
Aliases: | RunEvaluationAfterRestart |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica se utilizzare Wake-on-LAN per riattivare i client per le distribuzioni necessarie.
Type: | Boolean |
Aliases: | EnableWakeOnLan |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftDeadlineEnabled
Utilizzare questo parametro per impostare **** l'opzione seguente nella pagina Pianificazione distribuzione delle impostazioni di distribuzione DI ADR: Ritardare l'applicazione della distribuzione in base alle preferenze dell'utente, fino al periodo di tolleranza definito nelle impostazioni client.
Type: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessPercentage
Specifica la percentuale come numero intero di conformità client. Quando la conformità client scende al di sotto di questa percentuale, viene generato un avviso.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartServer
Indica se un riavvio del sistema viene eliminato nei server quando un aggiornamento software richiede un riavvio del sistema per completare il processo di installazione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuppressRestartWorkstation
Indica se un riavvio del sistema viene eliminato nelle workstation quando un aggiornamento software richiede un riavvio del sistema per completare il processo di installazione.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseBranchCache
Indica se ai client è consentito condividere contenuto con altri client nella stessa subnet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Specifica il comportamento di notifica dell'esperienza visiva dell'utente.
Type: | UserNotificationOption |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
Indica se la pianificazione per questa distribuzione viene valutata in base all'ora UTC (Universal Coordinated Time).
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLevel
Specifica la quantità di dettagli sullo stato che i client riportano per le distribuzioni create da questa regola.
Type: | VerboseLevelType |
Accepted values: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
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 |
-WriteFilterHandling
Indica se il commit delle modifiche viene eseguito alla scadenza o durante una finestra di manutenzione (richiede riavvii). Se impostato su $False
, il contenuto viene applicato alla sovrimpressione ed eseguito il commit in un secondo momento.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject