Get-CMSoftwareUpdateCategory
SYNOPSIS
Szoftverfrissítési besorolás vagy termék lekérte.
SYNTAX
ByName (alapértelmezett)
Get-CMSoftwareUpdateCategory [-Fast] [-Name <String>] [-TypeName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
ById (ById)
Get-CMSoftwareUpdateCategory [-Fast] -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
ByUniqueId (ByUniqueId)
Get-CMSoftwareUpdateCategory [-Fast] -UniqueId <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
Ezzel a parancsmagmal lekért egy objektumot egy szoftverfrissítési besoroláshoz vagy termékhez. A szoftverfrissítések metaadatait a rendszer a Konfigurációkezelő a szoftverfrissítési pont összetevő tulajdonságaiban megadott beállítások alapján olvassa be. További információ: Besorolások és termékek konfigurálása szinkronizáláshoz.
A parancsmag által visszaadott eredmények szűréséhez használja a CategoryTypeName és az IsSubscribed tulajdonságot. A kategóriatípusok közé tartozik az UpdateClassification, a Company, a ProductFamily és a Product. Ha az IsSubscribed tulajdonság True (Igaz), a hely a kategória szinkronizálására van konfigurálva.
Megjegyzés
Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\>
. További információ: Első lépések.
EXAMPLES
1. példa: Feliratkozott besorolások megjelenítése
Ez a példa lekérdezi a helyen az összes szinkronizált szoftverfrissítési besorolást.
Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName
Ha módosítania kell ezt a parancsot, hogy a webhely által nem szinkronizált besorolások listáját adja vissza, adja hozzá a not operátort ( ) az !
IsSubscribed tulajdonságra való hivatkozás előtt. Például: !$_.IsSubscribed
2. példa: Kategóriák száma típus szerint
Ez a példa azt számolja meg, hogy a webhely hány kategóriával rendelkezik az egyes típusokkal. Ez a szám segíthet megállapítani, hogy a szoftverfrissítési pont nincs-e szinkronban a felfelé irányuló forrással.
Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName
Count Name
----- ----
13 UpdateClassification
7 Company
59 ProductFamily
338 Product
3. példa: Termékek megjelenítése Office termékcsaládhoz
Ez a példa először lekérte a termék családkategóriáját a Office, majd a példányazonosítójával lekért minden gyermekkategóriát.
$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
4. példa: Az összes szoftverfrissítés le Office 365 ügyfél kategóriában
Ez a példa először a ügyfél termékkategóriáját Office 365, majd az összes szoftverfrissítést az adott kategóriában.
$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
Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fast (Gyors)
Adja hozzá ezt a paramétert, hogy ne frissítse automatikusan a lusta tulajdonságokat. A lusta tulajdonságok olyan értékeket tartalmaznak, amelyek lekérése viszonylag nem hatékony. Ezeknek a tulajdonságoknak a beszerzése további hálózati forgalmat okozhat, és csökkentheti a parancsmagok teljesítményét.
Ha nem használja ezt a paramétert, a parancsmag figyelmeztetést jelenít meg. A figyelmeztetés letiltásához állítsa be a (Beállítás) $CMPSSuppressFastNotUsedCheck = $true
halmazt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id (Azonosító)
Adja meg a lekért kategória azonosítóját.
Type: String
Parameter Sets: ById
Aliases: CategoryInstanceID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Adja meg a lekért kategória nevét.
Type: String
Parameter Sets: ByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-TypeName (Típusnév)
Adja meg a lekért kategória típusát. A gyakori értékek a következő típusok:
- UpdateClassification (Frissítés besorolása)
- Vállalat
- ProductFamily (Termékcsalád)
- Termék
Type: String
Parameter Sets: ByName
Aliases: CategoryTypeName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-UniqueId (Egyedi azonosító)
Adja meg a lekért kategória egyedi azonosítóját. Ez az érték a típus neve, a kategóriához tartozó GUID azonosítóval. Például: 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
Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.
INPUTS
None
OUTPUTS
IResultObject[]#SMS_UpdateCategoryInstance
IResultObject#SMS_UpdateCategoryInstance
MEGJEGYZÉSEK
További információ erről a visszatérési objektumról és tulajdonságairól: SMS_UpdateCategoryInstance WMI-osztály létrehozása.