Get-CMSoftwareUpdate
SYNOPSIS
Pobierz aktualizację oprogramowania.
SYNTAX
SearchByName (ustawienie domyślne)
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
Użyj tego polecenia cmdlet, aby pobrać co najmniej jedną aktualizację oprogramowania.
Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą zarządzania aktualizacjami oprogramowania w dokumentacji podstawowej.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Pobierz pobrane aktualizacje oprogramowania
To polecenie pobiera wszystkie aktualizacje oprogramowania pobrane przez witrynę.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Przykład 2: Uzyskiwanie aktualizacji oprogramowania według grupy aktualizacji
To polecenie najpierw pobiera obiekt grupy aktualizacji oprogramowania o nazwie TestSUgroup10. Następnie używa operatora potoku, aby przekazać obiekt do polecenia Get-CMSoftwareUpdate. Wynikiem jest lista wszystkich aktualizacji oprogramowania dla grupy aktualizacji oprogramowania.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate
PARAMETERS
-ArticleId
Określ identyfikator artykułu aktualizacji oprogramowania. Na przykład 4571687.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-BulletinId
Określ identyfikator biuletynu aktualizacji oprogramowania. Na przykład MS18-952.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Category (Kategoria)
Określ kategorię aktualizacji oprogramowania. Aby uzyskać obiekt kategorii, użyj polecenia cmdlet 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
Określ tablicę nazw kategorii aktualizacji oprogramowania.
Type: String[]
Parameter Sets: SearchByName
Aliases: CategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMax
Określ najpóźniejszą datę wydania aktualizacji oprogramowania.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMin
Określ najwcześniejszą datę wydania aktualizacji oprogramowania.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateRevisedMax
Określ najpóźniejszą datę zmiany aktualizacji oprogramowania.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateRevisedMin
Określ najwcześniejszą datę zmiany aktualizacji oprogramowania.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EulaExist
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich aktualizacji, które mają umowę licencyjną.
Type: Boolean
Parameter Sets: SearchByName
Aliases: EulaExists
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fast
Dodaj ten parametr, aby nie odświeżać automatycznie właściwości z opóźnieniem. Właściwości z opóźnieniem zawierają wartości, które są stosunkowo niewydajne do pobrania. Uzyskanie tych właściwości może spowodować dodatkowy ruch sieciowy i zmniejszyć wydajność polecenia cmdlet.
Jeśli nie używasz tego parametru, polecenie cmdlet wyświetli ostrzeżenie. Aby wyłączyć to ostrzeżenie, ustaw wartość $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id (Identyfikator)
Określa identyfikator aktualizacji oprogramowania. Ta wartość to CI_ID, na przykład 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
Dodaj ten parametr, aby uwzględnić aktualizacje oprogramowania w kategorii uaktualnienia.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases: IncludeUpgrades
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsContentProvisioned
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich aktualizacji, dla których witryna pobrała zawartość.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsDeployed
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich wdrożonych aktualizacji.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsExpired
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich wygasłych aktualizacji.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsLatest
Ustaw ten parametr na $true , aby filtrować wyniki dla najnowszej wersji aktualizacji oprogramowania.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsOfflineServiceable
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich aktualizacji, które mogą być dostępne w trybie offline. Możesz użyć narzędzia wiersza polecenia DISM, aby wstrzyknąć te aktualizacje do obrazu systemu operacyjnego.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsSuperseded
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich aktualizacji, które zostały nadsyłane.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsUserDefined
Ustaw ten parametr na $true , aby filtrować wyniki dla wszystkich aktualizacji zdefiniowanych przez użytkownika.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Określ nazwę aktualizacji oprogramowania. Ten parametr jest porównywany z atrybutem zlokalizowanej nazwy wyświetlanej.
Można używać symboli wieloznacznych:
*: wiele znaków?: pojedynczy znak
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-TylkoWydajone
Dodaj ten parametr, aby wyszukiwać tylko wygasłe aktualizacje oprogramowania.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ważność
Określ ważność aktualizacji oprogramowania.
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
Określ obiekt grupy aktualizacji oprogramowania. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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
Określ tablicę identyfikatorów grup aktualizacji oprogramowania. Ta wartość to CI_ID lub identyfikator elementu konfiguracji grupy aktualizacji oprogramowania. Na przykład 107078.
Type: String[]
Parameter Sets: SearchByUpdateGroupIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroupName
Określ tablicę nazw grup aktualizacji oprogramowania.
Type: String[]
Parameter Sets: SearchByUpdateGroupNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Dostawcy
Dotyczy wersji 2010 i nowszych. Określ nazwę dostawcy aktualizacji oprogramowania. Dostawca większości aktualizacji oprogramowania to "Microsoft" . Jeśli skonfigurujesz aktualizacje oprogramowania innych firm, użyj tej wartości, aby filtrować według innych dostawców aktualizacji.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_SoftwareUpdate
IResultObject#SMS_SoftwareUpdate
UWAGI
Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_SoftwareUpdate klasy WMI serwera.