Get-CMSoftwareUpdateCategory
SYNOPSIS
Získejte klasifikaci aktualizací softwaru nebo produkt.
SYNTAX
ByName (výchozí)
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
Pomocí této rutiny můžete získat objekt pro klasifikaci aktualizací softwaru nebo produkt. Metadata aktualizací softwaru se načítá během procesu synchronizace v Správce konfigurace na základě nastavení, které zadáte ve vlastnostech komponenty bodu aktualizace softwaru. Další informace najdete v tématu Konfigurace klasifikací a produktů k synchronizaci.
K filtrování výsledků, které tato rutina vrátí, použijte vlastnosti CategoryTypeName a IsSubscribed. Mezi typy kategorií patří UpdateClassification, Company, ProductFamily a Product. Pokud má vlastnost IsSubscribed hodnotu True, je web nakonfigurovaný tak, aby synchronizoval kategorii.
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: Zobrazení odebíraných klasifikací
Tento příklad se webu dotazuje na všechny klasifikace aktualizací softwaru, které synchronizuje.
Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName
Pokud chcete tento příkaz změnit tak, aby vracel seznam klasifikací, které web nesynchronuje, přidejte před odkaz na vlastnost ! IsSubscribed operátor not ( ). Například !$_.IsSubscribed.
Příklad 2: Počítání kategorií podle typu
Tento příklad spočítá, kolik kategorií má web pro každý typ. Tento počet vám může pomoct určit, jestli je bod aktualizace softwaru nesynchronní s upstreamový zdrojem.
Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName
Count Name
----- ----
13 UpdateClassification
7 Company
59 ProductFamily
338 Product
Příklad 3: Zobrazení produktů pro Office produktové skupiny
Tento příklad nejprve načte kategorii produktové Office a pak použije JEJÍ ID instance k získání všech podřízených kategorií.
$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
Příklad 4: Získání všech aktualizací softwaru v kategorii Office 365 Client
Tento příklad nejprve načte kategorii produktů pro Office 365 Client a pak získá všechny aktualizace softwaru v této 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
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
-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žijete, 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
Zadejte ID kategorie, která se má získat.
Type: String
Parameter Sets: ById
Aliases: CategoryInstanceID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Zadejte název kategorie, která se má získat.
Type: String
Parameter Sets: ByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-TypeName
Zadejte typ kategorie, která se má získat. Mezi běžné hodnoty patří následující typy:
- UpdateClassification
- Společnost
- 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
Zadejte jedinečné ID pro kategorii, která se má získat. Tato hodnota je název typu s identifikátorem GUID pro kategorii. Například 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
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
Žádná
OUTPUTS
IResultObject[]#SMS_UpdateCategoryInstance
IResultObject#SMS_UpdateCategoryInstance
POZNÁMKY
Další informace o tomto návratového objektu a jeho vlastnostech najdete v SMS_UpdateCategoryInstance serverové třídy služby WMI.