Get-CMSoftwareUpdateCategory
SYNOPSIS
Een software-updateclassificatie of -product downloaden.
SYNTAX
ByName (standaard)
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
Gebruik deze cmdlet om een -object voor een software-updateclassificatie of -product op te halen. Metagegevens van software-updates worden opgehaald tijdens het synchronisatieproces in Configuration Manager op basis van de instellingen die u opgeeft in de eigenschappen van het software-updatepuntonderdeel. Zie Classificaties en producten configureren om te synchroniseren voor meer informatie.
Als u de resultaten wilt filteren die deze cmdlet retourneert, gebruikt u de eigenschappen CategoryTypeName en IsSubscribed. De categorietypen zijn UpdateClassification, Company, ProductFamily en Product. Wanneer de eigenschap IsSubscribed True is, wordt de site geconfigureerd om die categorie te synchroniseren.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Geabonneerde classificaties tonen
In dit voorbeeld wordt op de site een query op alle software-updateclassificaties opgevraagd die worden gesynchroniseerd.
Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName
Als u deze opdracht wilt wijzigen om de lijst met classificaties te retourneren die de site niet synchroniseert, voegt u de not-operator ( ) toe vóór de verwijzing naar de eigenschap ! IsSubscribed. Bijvoorbeeld: !$_.IsSubscribed
Voorbeeld 2: Categorieën tellen op type
In dit voorbeeld wordt geteld hoeveel categorieën de site voor elk type heeft. Dit aantal kan u helpen bepalen of het software-updatepunt niet is gesynchroniseerd met de upstream-bron.
Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName
Count Name
----- ----
13 UpdateClassification
7 Company
59 ProductFamily
338 Product
Voorbeeld 3: Producten voor een Office productfamilie
In dit voorbeeld wordt eerst de productfamiliecategorie voor Office en wordt vervolgens de exemplaar-id gebruikt om alle onderliggende categorieën op te halen.
$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
Voorbeeld 4: Alle software-updates in Office 365 clientcategorie
In dit voorbeeld wordt eerst de productcategorie voor Office 365 Client en vervolgens worden alle software-updates in die categorie ontvangen.
$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
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Snel
Voeg deze parameter toe om niet automatisch luie eigenschappen te vernieuwen. Luie eigenschappen bevatten waarden die relatief inefficiënt zijn om op te halen. Het verkrijgen van deze eigenschappen kan extra netwerkverkeer veroorzaken en de prestaties van de cmdlet verlagen.
Als u deze parameter niet gebruikt, geeft de cmdlet een waarschuwing weer. Als u deze waarschuwing wilt uitschakelen, stelt u $CMPSSuppressFastNotUsedCheck = $true in.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Geef de id op van de categorie die u wilt op halen.
Type: String
Parameter Sets: ById
Aliases: CategoryInstanceID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Geef de naam op van de categorie die u wilt op halen.
Type: String
Parameter Sets: ByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-TypeName
Geef het type categorie op dat moet worden get. Algemene waarden zijn onder andere de volgende typen:
- UpdateClassification
- Bedrijf
- ProductFamily
- Product
Type: String
Parameter Sets: ByName
Aliases: CategoryTypeName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-UniqueId
Geef de unieke id op voor de categorie die moet worden get. Deze waarde is de typenaam met een GUID voor de categorie. Bijvoorbeeld: 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
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Geen
OUTPUTS
IResultObject[]#SMS_UpdateCategoryInstance
IResultObject#SMS_UpdateCategoryInstance
OPMERKINGEN
Zie WMI-klasse SMS_UpdateCategoryInstance server voor meer informatie over dit retourobject en deeigenschappen ervan.