Get-CMSoftwareUpdate
Ottenere un aggiornamento software.
Sintassi
Get-CMSoftwareUpdate
[-ArticleId <String>]
[-BulletinId <String>]
[-Category <IResultObject[]>]
[-CategoryName <String[]>]
[-DatePostedMax <DateTime>]
[-DatePostedMin <DateTime>]
[-DateRevisedMax <DateTime>]
[-DateRevisedMin <DateTime>]
[-EulaExist <Boolean>]
[-Fast]
[-IncludeUpgrade]
[-IsContentProvisioned <Boolean>]
[-IsDeployed <Boolean>]
[-IsExpired <Boolean>]
[-IsLatest <Boolean>]
[-IsOfflineServiceable <Boolean>]
[-IsSuperseded <Boolean>]
[-IsUserDefined <Boolean>]
[-Name <String>]
[-OnlyExpired]
[-Severity <CustomSeverityType>]
[-Vendor <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-Id <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-UpdateGroup <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-UpdateGroupId <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-UpdateGroupName <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Descrizione
Usare questo cmdlet per ottenere uno o più aggiornamenti software.
Per altre informazioni, vedere la documentazione sulla gestione degli aggiornamenti software nella documentazione di base.
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: Ottenere gli aggiornamenti software scaricati
Questo comando ottiene tutti gli aggiornamenti software scaricati dal sito.
Get-CMSoftwareUpdate -IsContentProvisioned $TrueEsempio 2: Ottenere gli aggiornamenti software per gruppo di aggiornamenti
Questo comando ottiene prima di tutto l'oggetto gruppo di aggiornamento software denominato TestSUgroup10. Usa quindi l'operatore della pipeline per passare l'oggetto a Get-CMSoftwareUpdate. Il risultato è l'elenco di tutti gli aggiornamenti software per il gruppo di aggiornamenti software.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdateParametri
-ArticleId
Specificare l'ID articolo di un aggiornamento software. Ad esempio, 4571687.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-BulletinId
Specificare l'ID bollettino di un aggiornamento software. Ad esempio, MS18-952.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-Category
Specificare la categoria di un aggiornamento software. Per ottenere un oggetto categoria, usare il cmdlet Get-CMSoftwareUpdateCategory .
| Tipo: | IResultObject[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-CategoryName
Specificare una matrice di nomi di categoria per gli aggiornamenti software.
| Tipo: | String[] |
| Alias: | CategoryNames |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DatePostedMax
Specificare la data più recente in cui è stato rilasciato un aggiornamento software.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DatePostedMin
Specificare la data meno recente in cui è stato rilasciato un aggiornamento software.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DateRevisedMax
Specificare la data più recente in cui è stato rivisto un aggiornamento software.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DateRevisedMin
Specificare la data meno recente in cui è stato rivisto un aggiornamento software.
| 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 |
-EulaExist
Impostare questo parametro su $true per filtrare i risultati per tutti gli aggiornamenti con contratto di licenza.
| Tipo: | Boolean |
| Alias: | EulaExists |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Fast
Aggiungere questo parametro per non aggiornare automaticamente le proprietà lazy. Le proprietà lazy contengono valori relativamente inefficienti da recuperare. Il recupero di queste proprietà può causare traffico di rete aggiuntivo e ridurre le prestazioni dei cmdlet.
Se non si usa questo parametro, il cmdlet visualizza un avviso. Per disabilitare questo avviso, impostare $CMPSSuppressFastNotUsedCheck = $true.
| Tipo: | SwitchParameter |
| 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 |
-Id
Specifica l'ID di un aggiornamento software. Questo valore è il CI_ID, ad esempio 143404.
| Tipo: | Int32 |
| Alias: | CIId, CI_ID |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IncludeUpgrade
Aggiungere questo parametro per includere gli aggiornamenti software nella categoria di aggiornamento.
| Tipo: | SwitchParameter |
| Alias: | IncludeUpgrades |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsContentProvisioned
Impostare questo parametro su $true per filtrare i risultati per tutti gli aggiornamenti per cui il sito ha scaricato il contenuto.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsDeployed
Impostare questo parametro su $true per filtrare i risultati per tutti gli aggiornamenti distribuiti.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsExpired
Impostare questo parametro su $true per filtrare i risultati per tutti gli aggiornamenti scaduti.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsLatest
Impostare questo parametro su $true per filtrare i risultati per la versione più recente dell'aggiornamento software.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsOfflineServiceable
Impostare questo parametro su per filtrare i risultati per tutti gli aggiornamenti che sono offline.Set this parameter to $true filter results for all updates that are offline-serviceable. È possibile usare lo strumento da riga di comando gestione e manutenzione immagini distribuzione per inserire questi aggiornamenti in un'immagine del sistema operativo.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsSuperseded
Impostare questo parametro su $true per filtrare i risultati per tutti gli aggiornamenti sostituiti.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-IsUserDefined
Impostare questo parametro su $true per filtrare i risultati per tutti gli aggiornamenti definiti dall'utente.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Specificare il nome di un aggiornamento software. Questo parametro viene confrontato con l'attributo del nome visualizzato localizzato.
È possibile usare caratteri jolly:
-
*: più caratteri -
?: carattere singolo
| Tipo: | String |
| Alias: | LocalizedDisplayName |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | True |
-OnlyExpired
Aggiungere questo parametro per cercare solo gli aggiornamenti software scaduti.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Severity
Specificare la gravità dell'aggiornamento software.
| Tipo: | CustomSeverityType |
| Valori accettati: | None, Low, Moderate, Important, Critical |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UpdateGroup
Specificare l'oggetto gruppo di aggiornamento software. Per ottenere questo oggetto, usare il cmdlet Get-CMSoftwareUpdateGroup .
| Tipo: | IResultObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-UpdateGroupId
Specificare una matrice di ID dei gruppi di aggiornamento software. Questo valore è l'ID CI_ID o dell'elemento di configurazione del gruppo di aggiornamento software. Ad esempio, 107078.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UpdateGroupName
Specificare una matrice di nomi di gruppi di aggiornamento software.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Vendor
Si applica alla versione 2010 e successive. Specificare il nome del fornitore dell'aggiornamento software. Il fornitore per la maggior parte degli aggiornamenti software è "Microsoft". Se si configurano aggiornamenti software di terze parti, usare questo valore per filtrare in base ad altri fornitori di aggiornamenti.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject[]
IResultObject
Note
Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_SoftwareUpdate classe WMI del server.