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
Utilizzare questo cmdlet per ottenere uno o più aggiornamenti software.
Per ulteriori informazioni, vedere la documentazione relativa alla gestione degli aggiornamenti software nei documenti principali.
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: Scaricare gli aggiornamenti software
Questo comando ottiene tutti gli aggiornamenti software scaricati dal sito.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Esempio 2: Ottenere aggiornamenti software per gruppo di aggiornamento
Questo comando ottiene innanzitutto l'oggetto gruppo di aggiornamento software denominato TestSUgroup10. Viene quindi utilizzato 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-CMSoftwareUpdate
Parametri
-ArticleId
Specificare l'ID articolo di un aggiornamento software. Ad esempio, 4571687
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-BulletinId
Specificare l'ID del bollettino di un aggiornamento software. Ad esempio, MS18-952
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Category
Specificare la categoria di un aggiornamento software. Per ottenere un oggetto categoria, utilizzare il cmdlet Get-CMSoftwareUpdateCategory.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CategoryName
Specificare una matrice di nomi di categoria per gli aggiornamenti software.
Type: | String[] |
Aliases: | CategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMax
Specificare la data più recente di rilascio di un aggiornamento software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMin
Specificare la prima data di rilascio di un aggiornamento software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMax
Specificare la data più recente in cui è stato rivisto un aggiornamento software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMin
Specificare la prima data di revisione di un aggiornamento software.
Type: | DateTime |
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 |
-EulaExist
Impostare questo parametro su per $true
filtrare i risultati per tutti gli aggiornamenti che dispongono di un contratto di licenza.
Type: | Boolean |
Aliases: | EulaExists |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 ulteriore traffico di rete e ridurre le prestazioni dei cmdlet.
Se non si utilizza questo parametro, il cmdlet visualizza un avviso. Per disabilitare questo avviso, impostare $CMPSSuppressFastNotUsedCheck = $true
.
Type: | SwitchParameter |
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 |
-Id
Specifica l'ID di un aggiornamento software. Questo valore è il CI_ID, ad esempio 143404
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeUpgrade
Aggiungere questo parametro per includere gli aggiornamenti software nella categoria di aggiornamento.
Type: | SwitchParameter |
Aliases: | IncludeUpgrades |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsContentProvisioned
Impostare questo parametro su $true
per filtrare i risultati per tutti gli aggiornamenti per i quali il sito ha scaricato contenuto.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsDeployed
Impostare questo parametro su $true
per filtrare i risultati per tutti gli aggiornamenti distribuiti.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsExpired
Impostare questo parametro su $true
per filtrare i risultati per tutti gli aggiornamenti scaduti.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsLatest
Impostare questo parametro su $true
per filtrare i risultati per la versione più recente dell'aggiornamento software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsOfflineServiceable
Impostare questo parametro su $true
per filtrare i risultati per tutti gli aggiornamenti non in linea. Puoi usare lo strumento da riga di comando Gestione e manutenzione immagini distribuzione per inserire questi aggiornamenti in un'immagine del sistema operativo.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsSuperseded
Impostare questo parametro su per filtrare i risultati per tutti $true
gli aggiornamenti sostituiti.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUserDefined
Impostare questo parametro su $true
per filtrare i risultati per tutti gli aggiornamenti definiti dall'utente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specificare il nome di un aggiornamento software. Questo parametro viene confrontato con l'attributo del nome visualizzato localizzato.
È possibile utilizzare i caratteri jolly:
*
: più caratteri?
: carattere singolo
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-OnlyExpired
Aggiungere questo parametro per cercare solo gli aggiornamenti software scaduti.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Severity
Specificare la gravità dell'aggiornamento software.
Type: | CustomSeverityType |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroup
Specificare l'oggetto gruppo di aggiornamento software. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMSoftwareUpdateGroup.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UpdateGroupId
Specificare una matrice di ID di gruppi di aggiornamenti software. Questo valore è l'CI_ID o l'ID elemento di configurazione del gruppo di aggiornamento software. Ad esempio, 107078
.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroupName
Specificare una matrice di nomi di gruppi di aggiornamento software.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Vendor
Si applica alla versione 2010 e successive. Specificare il nome del fornitore dell'aggiornamento software. Il fornitore della maggior parte degli aggiornamenti software è "Microsoft"
. Se si configurano aggiornamenti software di terze parti, utilizzare questo valore per filtrare in base ad altri fornitori di aggiornamenti.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject[]
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_SoftwareUpdate classe WMI del server.