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.

Get-CMSoftwareUpdateGroup

Save-CMSoftwareUpdate

Set-CMSoftwareUpdate

Sync-CMSoftwareUpdate

Get-CMSoftwareUpdateCategory