Get-CMSoftwareUpdate
SYNOPSIS
Získejte aktualizaci softwaru.
SYNTAX
SearchByName (výchozí)
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
Pomocí této rutiny můžete získat jednu nebo více aktualizací softwaru.
Další informace najdete v dokumentaci ke správě aktualizací softwaru v základní dokumentaci.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Získání stažených aktualizací softwaru
Tento příkaz získá všechny aktualizace softwaru, které web stáhl.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Příklad 2: Získání aktualizací softwaru podle skupiny aktualizací
Tento příkaz nejprve získá objekt skupiny aktualizací softwaru s názvem TestSUgroup10. Potom pomocí operátoru kanálu předá objekt do get-CMSoftwareUpdate. Výsledkem je seznam všech aktualizací softwaru pro skupinu aktualizací softwaru.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate
PARAMETERS
-ArticleId
Zadejte ID článku aktualizace softwaru. Například, 4571687.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-BulletinId
Zadejte ID bulletinu aktualizace softwaru. Například, MS18-952.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Category (Kategorie)
Zadejte kategorii aktualizace softwaru. Pokud chcete získat objekt category, použijte rutinu 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
Zadejte pole názvů kategorií pro aktualizace softwaru.
Type: String[]
Parameter Sets: SearchByName
Aliases: CategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMax
Zadejte nejnovější datum vydání aktualizace softwaru.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMin
Zadejte nejstarší datum vydání aktualizace softwaru.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateRevisedMax
Zadejte nejnovější datum revize aktualizace softwaru.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateRevisedMin
Zadejte nejstarší datum revize aktualizace softwaru.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EulaExist
Pokud chcete filtrovat výsledky všech aktualizací, které mají licenční smlouvu, $true nastavte tento parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases: EulaExists
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fast
Přidáním tohoto parametru se nebudou automaticky aktualizovat opožděné vlastnosti. Opožděné vlastnosti obsahují hodnoty, které jsou relativně neefektivní k načtení. Získání těchto vlastností může způsobit další síťový provoz a snížit výkon rutin.
Pokud tento parametr použít nechcete, rutina zobrazí upozornění. Pokud chcete toto upozornění zakázat, nastavte $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Určuje ID aktualizace softwaru. Tato hodnota je CI_ID, například 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
Přidejte tento parametr pro zahrnutí aktualizací softwaru do kategorie upgradu.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases: IncludeUpgrades
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsContentProvisioned
Pokud chcete filtrovat výsledky všech aktualizací, pro které web stáhl obsah, nastavte tento $true parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsDeployed
Pokud chcete filtrovat výsledky všech nasazených aktualizací, $true nastavte tento parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsExpired
Pokud chcete filtrovat výsledky všech aktualizací, jejichž $true platnost vypršela, nastavte tento parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsLatest
Pokud chcete filtrovat výsledky nejnovější verze aktualizace softwaru, nastavte tento $true parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsOfflineServiceable
Pokud chcete filtrovat výsledky pro všechny aktualizace, které jsou možné offline, nastavte tento $true parametr na . K vložení těchto aktualizací do image operačního systému můžete použít nástroj příkazového řádku DISM.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsSuperseded
Pokud chcete filtrovat výsledky všech aktualizací, které jsou $true naháněny, nastavte tento parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsUserDefined
Pokud chcete filtrovat výsledky všech aktualizací definovaných uživatelem, nastavte tento $true parametr na .
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Zadejte název aktualizace softwaru. Tento parametr porovnává atribut lokalizovaného zobrazovaný název.
Můžete použít zástupné znaky:
*: Více znaků?: Jeden znak
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-OnlyExpired
Přidáním tohoto parametru vyhledáte jenom aktualizace softwaru, jejichž platnost vypršela.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Severity (Závažnost)
Zadejte závažnost aktualizace softwaru.
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
Zadejte objekt skupiny aktualizací softwaru. K získání tohoto objektu použijte rutinu 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
Zadejte pole ID skupin aktualizací softwaru. Tato hodnota je CI_ID nebo ID položky konfigurace skupiny aktualizací softwaru. Například, 107078.
Type: String[]
Parameter Sets: SearchByUpdateGroupIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroupName
Zadejte pole názvů skupin aktualizací softwaru.
Type: String[]
Parameter Sets: SearchByUpdateGroupNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Vendor (Dodavatel)
Platí pro verzi 2010 a novější. Zadejte název dodavatele aktualizace softwaru. Dodavatel většiny aktualizací softwaru je "Microsoft" . Pokud nakonfigurujete aktualizace softwaru třetích stran, použijte tuto hodnotu k filtrování podle jiných dodavatelů aktualizací.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_SoftwareUpdate
IResultObject#SMS_SoftwareUpdate
POZNÁMKY
Další informace o tomto návratového objektu a jeho vlastnostech najdete v SMS_SoftwareUpdate rozhraní WMI.