Get-CMSoftwareUpdate
SYNOPSIS
Hämta en programuppdatering.
SYNTAX
SearchByName (standard)
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>]
SearchById
Get-CMSoftwareUpdate [-Fast] -Id <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroup
Get-CMSoftwareUpdate [-Fast] -UpdateGroup <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroupIdMandatory
Get-CMSoftwareUpdate [-Fast] -UpdateGroupId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroupNameMandatory
Get-CMSoftwareUpdate [-Fast] -UpdateGroupName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
Använd den här cmdleten för att hämta en eller flera programuppdateringar.
Mer information finns i dokumentationen om hantering av programuppdateringar i kärndokumenten.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Hämta nedladdade programuppdateringar
Det här kommandot hämtar alla programuppdateringar som webbplatsen har laddat ned.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Exempel 2: Hämta programuppdateringar efter uppdateringsgrupp
Det här kommandot hämtar först programuppdateringsgruppens objekt med namnet TestSUgroup10. Den använder sedan pipelineoperatorn för att skicka objektet till Get-CMSoftwareUpdate. Resultatet är listan över alla programuppdateringar för programuppdateringsgruppen.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate
PARAMETERS
-ArticleId
Ange artikel-ID för en programuppdatering. Till exempel 4571687.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-BulletinId
Ange anslags-ID för en programuppdatering. Till exempel MS18-952.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Kategori
Ange kategorin för en programuppdatering. Om du vill hämta ett kategoriobjekt använder du cmdleten Get-CMSoftwareUpdateCategory.
Type: IResultObject[]
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-CategoryName
Ange en matris med kategorinamn för programuppdateringar.
Type: String[]
Parameter Sets: SearchByName
Aliases: CategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMax
Ange det senaste datumet då en programuppdatering släpptes.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMin
Ange det tidigaste datumet då en programuppdatering släpptes.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateReviseradeMax
Ange det senaste datumet då en programuppdatering ändrades.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateReviseradeMin
Ange det tidigaste datumet då en programuppdatering ändrades.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EulaExist
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som har ett licensavtal.
Type: Boolean
Parameter Sets: SearchByName
Aliases: EulaExists
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Snabb
Lägg till den här parametern för att inte uppdatera lazy-egenskaper automatiskt. Lazy-egenskaper innehåller värden som är relativt ineffektiva att hämta. Att hämta dessa egenskaper kan orsaka ytterligare nätverkstrafik och minska cmdlet-prestanda.
Om du inte använder den här parametern visar cmdleten en varning. Om du vill inaktivera den här varningen anger du $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Anger ID för en programuppdatering. Det här värdet är CI_ID, till exempel 143404 .
Type: Int32
Parameter Sets: SearchById
Aliases: CIId, CI_ID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeUpgrade
Lägg till den här parametern för att inkludera programuppdateringar i uppgraderingskategorin.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases: IncludeUpgrades
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsContentProvisioned
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som webbplatsen har laddat ned innehåll för.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsDeployed
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som distribueras.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsExpired
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som har upphört att gälla.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsLatest
Ange den här $true parametern till för att filtrera resultaten för den senaste versionen av programuppdateringen.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsOfflineServiceable
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som kan användas offline. Du kan använda kommandoradsverktyget DISM för att mata in dessa uppdateringar i en OPERATIVSYSTEMavbildning.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsSuperseded
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som ersätts.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsUserDefined
Ange den här $true parametern till för att filtrera resultaten för alla uppdateringar som är användardefinierade.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Ange namnet på en programuppdatering. Den här parametern jämförs med attributet för lokaliserat visningsnamn.
Du kan använda jokertecken:
*: Flera tecken?: Enskilt tecken
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-OnlyExpired
Lägg till den här parametern för att endast söka efter programuppdateringar som har upphört att gälla.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Allvarlighetsgrad
Ange allvarlighetsgraden för programuppdateringen.
Type: CustomSeverityType
Parameter Sets: SearchByName
Aliases:
Accepted values: None, Low, Moderate, Important, Critical
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroup
Ange programuppdateringsgruppsobjekt. Hämta det här objektet med hjälp av cmdleten Get-CMSoftwareUpdateGroup.
Type: IResultObject
Parameter Sets: SearchByUpdateGroup
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-UpdateGroupId
Ange en matris med ID:er med programuppdateringsgrupper. Det här värdet är CI_ID eller konfigurationsobjekt-ID för programuppdateringsgruppen. Till exempel 107078.
Type: String[]
Parameter Sets: SearchByUpdateGroupIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroupName
Ange en matris med namn på programuppdateringsgrupper.
Type: String[]
Parameter Sets: SearchByUpdateGroupNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Leverantör
Gäller för version 2010 och senare. Ange namnet på programuppdateringsleverantören. Leverantören för de flesta programuppdateringar är "Microsoft" . Om du konfigurerar programuppdateringar från tredje part använder du det här värdet för att filtrera på andra uppdateringsleverantörer.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_SoftwareUpdate
IResultObject#SMS_SoftwareUpdate
ANTECKNINGAR
Mer information om det här returobjektet och dess egenskaper finns i SMS_SoftwareUpdate serverns WMI-klass.