Get-CMSoftwareUpdate
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 $TrueBeispiel 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-CMSoftwareUpdateParameter
-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.