Get-CMSoftwareUpdateCategory
SYNOPSIS
Hämta en programuppdateringsklassificering eller -produkt.
SYNTAX
ByName (standard)
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
Använd den här cmdleten för att hämta ett objekt för en programuppdateringsklassificering eller -produkt. Metadata för programuppdateringar hämtas under synkroniseringsprocessen i Konfigurationshanteraren baserat på de inställningar som du anger i egenskaperna för programuppdateringsplatsens komponent. Mer information finns i Konfigurera klassificeringar och produkter som ska synkroniseras.
Om du vill filtrera resultaten som denna cmdlet returnerar använder du egenskaperna CategoryTypeName och IsSubscribed. Kategorityperna är UpdateClassification, Company, ProductFamily och Product. När egenskapen IsSubscribed är True konfigureras platsen för att synkronisera den kategorin.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Visa prenumererade klassificeringar
Det här exemplet frågar webbplatsen efter alla programuppdateringsklassificeringar som den synkroniserar.
Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName
Om du vill ändra det här kommandot för att returnera listan över klassificeringar som platsen inte synkroniserar lägger du till operatorn not ( ) före referensen till egenskapen ! IsSubscribed. Till exempel !$_.IsSubscribed
Exempel 2: Räkna kategorier efter typ
I det här exemplet räknas hur många kategorier webbplatsen har för varje typ. Det här antalet kan hjälpa dig att avgöra om programuppdateringsplatsen inte är synkroniserad med den överordnade källan.
Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName
Count Name
----- ----
13 UpdateClassification
7 Company
59 ProductFamily
338 Product
Exempel 3: Visa produkter Office en produktfamilj
Det här exemplet hämtar först produktfamiljekategorin för Office och använder sedan dess instans-ID för att hämta alla underordnade kategorier.
$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
Exempel 4: Hämta alla programuppdateringar i Office 365 klientkategori
Det här exemplet hämtar först produktkategorin för Office 365 Client och hämtar sedan alla programuppdateringar i den kategorin.
$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
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Snabb
Lägg till den här parametern för att inte uppdatera lazy-egenskaper automatiskt. Lazy-egenskaper innehåller värden som är relativt ineffektiva att hämta. Att hämta dessa egenskaper kan orsaka ytterligare nätverkstrafik och minska cmdlet-prestanda.
Om du inte använder den här parametern visar cmdleten en varning. Om du vill inaktivera den här varningen anger du $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Ange ID för den kategori som ska hämtas.
Type: String
Parameter Sets: ById
Aliases: CategoryInstanceID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Ange namnet på den kategori som ska hämtas.
Type: String
Parameter Sets: ByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-TypeName
Ange vilken typ av kategori som ska hämtas. Vanliga värden omfattar följande typer:
- UpdateClassification
- Företag
- 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
Ange det unika ID:t för den kategori som ska hämtas. Det här värdet är typnamnet med ett GUID för kategorin. Till exempel 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
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Ingen
OUTPUTS
IResultObject[]#SMS_UpdateCategoryInstance
IResultObject#SMS_UpdateCategoryInstance
ANTECKNINGAR
Mer information om det här returobjektet och dess egenskaper finns i SMS_UpdateCategoryInstance serverns WMI-klass.