Get-CMSoftwareUpdate

  • Referenz
Modul:
ConfigurationManager

Abrufen eines Softwareupdates.

Syntax

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein oder mehrere Softwareupdates abzurufen.

Weitere Informationen finden Sie in der Dokumentation zur Softwareupdateverwaltung in der Hauptdokumentation.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Herunterladen von Softwareupdates

Dieser Befehl ruft alle Softwareupdates ab, die von der Website heruntergeladen wurden.

Get-CMSoftwareUpdate -IsContentProvisioned $True

Beispiel 2: Abrufen von Softwareupdates nach Updategruppe

Dieser Befehl ruft zuerst das Softwareupdategruppenobjekt mit dem Namen TestSUgroup10 ab. Anschließend wird der Pipelineoperator verwendet, um das Objekt an Get-CMSoftwareUpdate zu übergeben. Das Ergebnis ist die Liste aller Softwareupdates für die Softwareupdategruppe.

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

Parameter

-ArticleId

Geben Sie die Artikel-ID eines Softwareupdates an. Beispiel: 4571687.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-BulletinId

Geben Sie die Bulletin-ID eines Softwareupdates an. Beispiel: MS18-952.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Category

Geben Sie die Kategorie eines Softwareupdates an. Verwenden Sie zum Abrufen eines Kategorieobjekts das Cmdlet Get-CMSoftwareUpdateCategory .

Typ:IResultObject[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CategoryName

Geben Sie ein Array von Kategorienamen für Softwareupdates an.

Typ:String[]
Aliase:CategoryNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatePostedMax

Geben Sie das letzte Datum an, an dem ein Softwareupdate veröffentlicht wurde.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatePostedMin

Geben Sie das früheste Datum an, an dem ein Softwareupdate veröffentlicht wurde.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DateRevisedMax

Geben Sie das letzte Datum an, an dem ein Softwareupdate überarbeitet wurde.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DateRevisedMin

Geben Sie das früheste Datum an, an dem ein Softwareupdate überarbeitet wurde.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EulaExist

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle Updates zu filtern, die über einen Lizenzvertrag verfügen.

Typ:Boolean
Aliase:EulaExists
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt die ID eines Softwareupdates an. Dieser Wert ist der CI_ID, z. B 143404. .

Typ:Int32
Aliase:CIId, CI_ID
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeUpgrade

Fügen Sie diesen Parameter hinzu, um Softwareupdates in die Upgradekategorie einzuschließen.

Typ:SwitchParameter
Aliase:IncludeUpgrades
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsContentProvisioned

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle Updates zu filtern, für die die Website Inhalte heruntergeladen hat.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsDeployed

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle bereitgestellten Updates zu filtern.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsExpired

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle abgelaufenen Updates zu filtern.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsLatest

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für die neueste Version des Softwareupdates zu filtern.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsOfflineServiceable

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle Updates zu filtern, die offline gewartet werden können. Sie können das DISM-Befehlszeilentool verwenden, um diese Updates in ein Betriebssystemimage einzufügen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsSuperseded

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle abgelösten Updates zu filtern.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsUserDefined

Legen Sie diesen Parameter auf fest $true , um die Ergebnisse für alle benutzerdefinierten Updates zu filtern.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen eines Softwareupdates an. Dieser Parameter wird mit dem lokalisierten Anzeigenamensattribut verglichen.

Sie können Ein-/Auslesezeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen
Typ:String
Aliase:LocalizedDisplayName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-OnlyExpired

Fügen Sie diesen Parameter hinzu, um nur nach abgelaufenen Softwareupdates zu suchen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Severity

Geben Sie den Schweregrad des Softwareupdates an.

Typ:CustomSeverityType
Zulässige Werte:None, Low, Moderate, Important, Critical
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpdateGroup

Geben Sie das Softwareupdategruppenobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSoftwareUpdateGroup .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-UpdateGroupId

Geben Sie ein Array von IDs von Softwareupdategruppen an. Dieser Wert ist die CI_ID - oder Konfigurationselement-ID der Softwareupdategruppe. Beispiel: 107078.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpdateGroupName

Geben Sie ein Array von Namen von Softwareupdategruppen an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Vendor

Gilt für Version 2010 und höher. Geben Sie den Namen des Softwareupdateanbieters an. Der Hersteller für die meisten Softwareupdates ist "Microsoft". Wenn Sie Softwareupdates von Drittanbietern konfigurieren, verwenden Sie diesen Wert, um nach anderen Updateanbietern zu filtern.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_SoftwareUpdate WMI-Serverklasse.