Share via

Get-CMSoftwareUpdateCategory

  • 참조
모듈:
ConfigurationManager

소프트웨어 업데이트 분류 또는 제품을 가져옵니다.

Syntax

Get-CMSoftwareUpdateCategory
   [-Fast]
   [-Name <String>]
   [-TypeName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdateCategory
   [-Fast]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdateCategory
   [-Fast]
   -UniqueId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 소프트웨어 업데이트 분류 또는 제품에 대한 개체를 가져옵니다. 소프트웨어 업데이트 메타데이터는 소프트웨어 업데이트 지점 구성 요소 속성에 지정한 설정에 따라 Configuration Manager 동기화 프로세스 중에 검색됩니다. 자세한 내용은 동기화할 분류 및 제품 구성을 참조하세요.

이 cmdlet이 반환하는 결과를 필터링하려면 CategoryTypeName 및 IsSubscribed 속성을 사용합니다. 범주 유형에는 UpdateClassification, Company, ProductFamily 및 Product가 포함 됩니다. IsSubscribed 속성이 True이면 사이트가 해당 범주를 동기화하도록 구성됩니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 구독된 분류 표시

다음은 동기화 중인 모든 소프트웨어 업데이트 분류에 대해 사이트를 쿼리하는 예제입니다.

Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName

사이트가 동기화되지 않는 분류 목록을 반환하도록 이 명령을 변경하려면 IsSubscribed 속성에 대한 참조 앞에 not 연산자(!)를 추가합니다. 예를 들면 !$_.IsSubscribed

예제 2: 형식별 범주 수

이 예제에서는 각 유형에 대해 사이트의 범주 수를 계산합니다. 이 개수는 소프트웨어 업데이트 지점이 업스트림 원본과 동기화되지 않도록 설정하는 데 도움이 될 수 있습니다.

Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName

Count Name
----- ----
   13 UpdateClassification
    7 Company
   59 ProductFamily
  338 Product

예제 3: Office 제품 제품군 제품 표시

이 예제에서는 먼저 Office의 제품 제품군 범주를 가져오고 인스턴스 ID를 사용하여 모든 자식 범주를 가져옵니다.

$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: Office 365 클라이언트 범주에서 모든 소프트웨어 업데이트 가져오기

이 예제에서는 먼저 Office 365 Client의 제품 범주를 가져오고 해당 범주의 모든 소프트웨어 업데이트를 가져옵니다.

$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

매개 변수

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Fast

지연 속성을 자동으로 새로 고치지 않도록 이 매개 변수를 추가합니다. 지연 속성에는 검색에 상대적으로 비효율적인 값이 포함됩니다. 이러한 속성을 가져오면 추가 네트워크 트래픽이 발생하고 cmdlet 성능이 저하될 수 있습니다.

이 매개 변수를 사용하지 않으면 cmdlet에 경고가 표시됩니다. 이 경고를 사용하지 않도록 설정하려면 를 설정합니다 $CMPSSuppressFastNotUsedCheck = $true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

가져올 범주의 ID를 지정합니다.

Type:String
Aliases:CategoryInstanceID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

가져올 범주의 이름을 지정합니다.

Type:String
Aliases:LocalizedCategoryInstanceName, CategoryName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-TypeName

가져올 범주 유형을 지정합니다. 일반적인 값은 다음과 같은 형식을 포함합니다.

  • UpdateClassification
  • Company
  • 제품군
  • 제품
Type:String
Aliases:CategoryTypeName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-UniqueId

가져올 범주의 고유 ID를 지정합니다. 이 값은 범주에 대한 GUID가 있는 형식 이름입니다. 예를 들면 UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

Type:String
Aliases:CategoryInstance_UniqueID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_UpdateCategoryInstance 서버 WMI 클래스를 참조하세요.