Get-CMSoftwareUpdateCategory

SYNOPSIS

Uzyskaj klasyfikację lub produkt aktualizacji oprogramowania.

SYNTAX

ByName (wartość domyślna)

Get-CMSoftwareUpdateCategory [-Fast] [-Name <String>] [-TypeName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

ById

Get-CMSoftwareUpdateCategory [-Fast] -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

ByUniqueId

Get-CMSoftwareUpdateCategory [-Fast] -UniqueId <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

To polecenie cmdlet umożliwia uzyskiwanie obiektu klasyfikacji lub produktu aktualizacji oprogramowania. Metadane aktualizacji oprogramowania są pobierane podczas procesu synchronizacji w programie Menedżer konfiguracji na podstawie ustawień określanych we właściwościach składnika punktu aktualizacji oprogramowania. Aby uzyskać więcej informacji, zobacz Configure classifications and products to synchronize (Konfigurowanie klasyfikacji i produktów w celu synchronizacji).

Aby filtrować wyniki zwracane przez to polecenie cmdlet, użyj właściwości CategoryTypeName i IsSubscribed. Typy kategorii obejmują UpdateClassification, Company, ProductFamily i Product. Jeśli właściwość IsSubscribed ma wartość True, lokacja jest skonfigurowana do synchronizowania tej kategorii.

EXAMPLES

Przykład 1: Wyświetlanie subskrybowanych klasyfikacji

W tym przykładzie program wysyła do lokacji zapytanie o wszystkie klasyfikacje aktualizacji oprogramowania, które są synchronizowane.

Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName

Aby zmienić to polecenie, aby zwrócić listę klasyfikacji, których lokacja nie synchronizuje, dodaj operator not ( ) przed odwołaniem do właściwości ! IsSubscribed. Na przykład !$_.IsSubscribed

Przykład 2: zliczanie kategorii według typu

Ten przykład zlicza kategorie witryny dla każdego typu. Ta liczba może pomóc w ustaleniu, czy punkt aktualizacji oprogramowania nie jest zsynchronizowany ze źródłem nadrzędnym.

Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName

Count Name
----- ----
   13 UpdateClassification
    7 Company
   59 ProductFamily
  338 Product

Przykład 3: Pokazywanie produktów dla Office rodziny produktów

Ten przykład najpierw pobiera kategorię rodziny produktów dla Office , a następnie używa identyfikatora wystąpienia do uzyskania wszystkich kategorii podrzędnej.

$officeFamily = Get-CMSoftwareUpdateCategory -Fast -TypeName "ProductFamily" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office" }

Get-CMSoftwareUpdateCategory -Fast | Where-Object ParentCategoryInstanceId -eq $officeFamily.CategoryInstanceID | Select-Object LocalizedCategoryInstanceName,CategoryTypeName

LocalizedCategoryInstanceName         CategoryTypeName
-----------------------------         ----------------
Dictionary Updates for Microsoft IMEs Product
New Dictionaries for Microsoft IMEs   Product
Office 2002/XP                        Product
Office 2003                           Product
Office 2007                           Product
Office 2010                           Product
Office 2013                           Product
Office 2016                           Product
Office 365 Client                     Product
Office 2019                           Product

Przykład 4: Pobierz wszystkie aktualizacje oprogramowania w Office 365 Client

Ten przykład najpierw pobiera kategorię produktu dla Office 365 , a następnie pobiera wszystkie aktualizacje oprogramowania w tej kategorii.

$cat = Get-CMSoftwareUpdateCategory -Fast -TypeName "Product" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office 365 Client" }

Get-CMSoftwareUpdate -Fast -Category $cat | Select-Object ArticleID,LocalizedDisplayName,IsDeployed,IsSuperseded,NumTotal,NumMissing

PARAMETERS

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. 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

-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śl identyfikator kategorii do uzyskania.

Type: String
Parameter Sets: ById
Aliases: CategoryInstanceID

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Określ nazwę kategorii do uzyskania.

Type: String
Parameter Sets: ByName
Aliases: LocalizedCategoryInstanceName, CategoryName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-TypeName

Określ typ kategorii do uzyskania. Typowe wartości obejmują następujące typy:

• UpdateClassification
• Firma
• ProductFamily
• Produkt

Type: String
Parameter Sets: ByName
Aliases: CategoryTypeName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-UniqueId

Określ unikatowy identyfikator dla kategorii do uzyskania. Ta wartość jest nazwą typu z identyfikatorem GUID kategorii. Na przykład UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

Type: String
Parameter Sets: ByUniqueId
Aliases: CategoryInstance_UniqueID

Required: True
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

Brak

OUTPUTS

IResultObject[]#SMS_UpdateCategoryInstance

IResultObject#SMS_UpdateCategoryInstance

UWAGI

Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_UpdateCategoryInstance klasy WMI serwera.

RELATED LINKS

Get-CMSoftwareUpdate