다음을 통해 공유


Get-CMSoftwareUpdate

소프트웨어 업데이트를 가져옵니다.

구문

Get-CMSoftwareUpdate
   [-ArticleId <String>]
   [-BulletinId <String>]
   [-Category <IResultObject[]>]
   [-CategoryName <String[]>]
   [-DatePostedMax <DateTime>]
   [-DatePostedMin <DateTime>]
   [-DateRevisedMax <DateTime>]
   [-DateRevisedMin <DateTime>]
   [-EulaExist <Boolean>]
   [-Fast]
   [-IncludeUpgrade]
   [-IsContentProvisioned <Boolean>]
   [-IsDeployed <Boolean>]
   [-IsExpired <Boolean>]
   [-IsLatest <Boolean>]
   [-IsOfflineServiceable <Boolean>]
   [-IsSuperseded <Boolean>]
   [-IsUserDefined <Boolean>]
   [-Name <String>]
   [-OnlyExpired]
   [-Severity <CustomSeverityType>]
   [-Vendor <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -Id <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupId <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupName <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 하나 이상의 소프트웨어 업데이트를 가져옵니다.

자세한 내용은 핵심 문서의 소프트웨어 업데이트 관리 설명서를 참조하세요.

참고

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

예제

예제 1: 다운로드한 소프트웨어 업데이트 가져오기

이 명령은 사이트에서 다운로드한 모든 소프트웨어 업데이트를 가져옵니다.

Get-CMSoftwareUpdate -IsContentProvisioned $True

예제 2: 업데이트 그룹별 소프트웨어 업데이트 가져오기

이 명령은 먼저 TestSUgroup10이라는 소프트웨어 업데이트 그룹 개체를 가져옵니다. 그런 다음 파이프라인 연산자를 사용하여 개체를 Get-CMSoftwareUpdate에 전달합니다. 결과는 소프트웨어 업데이트 그룹에 대한 모든 소프트웨어 업데이트 목록입니다.

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

매개 변수

-ArticleId

소프트웨어 업데이트의 아티클 ID 를 지정합니다. 예를 들면 4571687와 같습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-BulletinId

소프트웨어 업데이트의 공지 ID 를 지정합니다. 예를 들면 MS18-952와 같습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-Category

소프트웨어 업데이트의 범주를 지정합니다. 범주 개체를 얻으려면 Get-CMSoftwareUpdateCategory cmdlet을 사용합니다.

형식:IResultObject[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-CategoryName

소프트웨어 업데이트에 대한 범주 이름 배열을 지정합니다.

형식:String[]
별칭:CategoryNames
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DatePostedMax

소프트웨어 업데이트가 릴리스된 최신 날짜를 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DatePostedMin

소프트웨어 업데이트가 릴리스된 가장 이른 날짜를 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DateRevisedMax

소프트웨어 업데이트가 수정된 최신 날짜를 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DateRevisedMin

소프트웨어 업데이트가 수정된 가장 이른 날짜를 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EulaExist

라이선스 계약이 있는 $true 모든 업데이트에 대한 결과를 필터링하려면 이 매개 변수를 로 설정합니다.

형식:Boolean
별칭:EulaExists
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Fast

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

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

소프트웨어 업데이트의 ID를 지정합니다. 이 값은 CI_ID(예 143404: )입니다.

형식:Int32
별칭:CIId, CI_ID
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IncludeUpgrade

업그레이드 범주에 소프트웨어 업데이트를 포함하려면 이 매개 변수를 추가합니다.

형식:SwitchParameter
별칭:IncludeUpgrades
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsContentProvisioned

사이트에서 콘텐츠를 다운로드한 $true 모든 업데이트에 대한 결과를 필터링하려면 이 매개 변수를 로 설정합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsDeployed

배포된 모든 업데이트에 대한 결과를 필터링하려면 이 매개 변수 $true 를 로 설정합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsExpired

만료된 모든 업데이트에 대한 결과를 필터링하려면 이 매개 변수 $true 를 로 설정합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsLatest

소프트웨어 업데이트의 최신 버전에 대한 결과를 필터링하려면 이 매개 변수 $true 를 로 설정합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsOfflineServiceable

오프라인 서비스 가능한 모든 업데이트에 대한 결과를 필터링하려면 이 매개 변수 $true 를 로 설정합니다. DISM 명령줄 도구를 사용하여 이러한 업데이트를 OS 이미지에 삽입할 수 있습니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsSuperseded

대체되는 모든 업데이트에 대한 결과를 필터링하려면 이 매개 변수 $true 를 로 설정합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IsUserDefined

이 매개 변수를 로 $true 설정하여 사용자가 정의한 모든 업데이트에 대한 결과를 필터링합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

소프트웨어 업데이트의 이름을 지정합니다. 이 매개 변수는 지역화된 표시 이름 특성과 비교됩니다.

와일드카드 문자를 사용할 수 있습니다.

  • *: 여러 문자
  • ?: 단일 문자
형식:String
별칭:LocalizedDisplayName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-OnlyExpired

만료된 소프트웨어 업데이트만 검색하려면 이 매개 변수를 추가합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Severity

소프트웨어 업데이트의 심각도를 지정합니다.

형식:CustomSeverityType
허용되는 값:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateGroup

소프트웨어 업데이트 그룹 개체를 지정합니다. 이 개체를 얻으려면 Get-CMSoftwareUpdateGroup cmdlet을 사용합니다.

형식:IResultObject
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-UpdateGroupId

소프트웨어 업데이트 그룹의 ID 배열을 지정합니다. 이 값은 소프트웨어 업데이트 그룹의 CI_ID 또는 구성 항목 ID 입니다. 예를 들면 107078와 같습니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateGroupName

소프트웨어 업데이트 그룹의 이름 배열을 지정합니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Vendor

버전 2010 이상에 적용됩니다. 소프트웨어 업데이트 공급업체의 이름을 지정합니다. 대부분의 소프트웨어 업데이트 공급업체는 입니다 "Microsoft". 타사 소프트웨어 업데이트를 구성하는 경우 이 값을 사용하여 다른 업데이트 공급업체를 필터링합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject[]

IResultObject

참고

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