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.
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: 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.