Get-CMSoftwareUpdate
Rufen Sie ein Softwareupdate ab.
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 Verwaltung von Softwareupdates in den Kerndokumenten.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Herunterladen von Softwareupdates
Mit diesem Befehl werden alle Softwareupdates abgerufen, die die Website heruntergeladen hat.
Get-CMSoftwareUpdate -IsContentProvisioned $TrueBeispiel 2: Abrufen von Softwareupdates nach Updategruppe
Mit diesem Befehl wird zunächst das Softwareupdate-Gruppenobjekt namens "TestSUgroup10" zurückgegeben. Anschließend wird der Pipelineoperator verwendet, um das Objekt an Get-CMSoftwareUpdatezu ü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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-BulletinId
Geben Sie dieBulletin-ID eines Softwareupdates an. Beispiel: MS18-952.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Category
Geben Sie die Kategorie eines Softwareupdates an. Verwenden Sie zum Abrufen eines Kategorieobjekts das Cmdlet "Get-CMSoftwareUpdateCategory".
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CategoryName
Geben Sie ein Array von Kategorienamen für Softwareupdates an.
| Type: | String[] |
| Aliases: | CategoryNames |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatePostedMax
Geben Sie das neueste Datum an, an dem ein Softwareupdate veröffentlicht wurde.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatePostedMin
Geben Sie den frühesten Zeitpunkt an, an dem ein Softwareupdate veröffentlicht wurde.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DateRevisedMax
Geben Sie das neueste Datum an, an dem ein Softwareupdate überarbeitet wurde.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DateRevisedMin
Geben Sie den frühesten Zeitpunkt an, an dem ein Softwareupdate überarbeitet wurde.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EulaExist
Legen Sie diesen Parameter $true fest, um Die Ergebnisse für alle Updates zu filtern, die über einen Lizenzvertrag verfügen.
| Type: | Boolean |
| Aliases: | EulaExists |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Fast
Fügen Sie diesen Parameter hinzu, um nicht automatisch verzögerte Eigenschaften zu aktualisieren. Lazy-Eigenschaften enthalten Werte, die relativ ineffizient abzurufen sind. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Leistung von Cmdlets verringern.
Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie $CMPSSuppressFastNotUsedCheck = $true fest.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Gibt die ID eines Softwareupdates an. Dieser Wert ist der CI_ID, 143404 z. B. .
| Type: | Int32 |
| Aliases: | CIId, CI_ID |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeUpgrade
Fügen Sie diesen Parameter hinzu, um Softwareupdates in die Upgradekategorie einzuschließen.
| Type: | SwitchParameter |
| Aliases: | IncludeUpgrades |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsContentProvisioned
Legen Sie diesen Parameter $true fest, um die Ergebnisse nach allen Updates zu filtern, für die die Website Inhalte heruntergeladen hat.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsDeployed
Legen Sie diesen Parameter so $true fest, dass die Ergebnisse nach allen bereitgestellten Updates gefiltert werden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsExpired
Legen Sie diesen Parameter so $true fest, dass die Ergebnisse nach allen abgelaufenen Updates gefiltert werden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsLatest
Legen Sie diesen Parameter $true fest, um die Ergebnisse nach der neuesten Version des Softwareupdates zu filtern.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsOfflineServiceable
Legen Sie diesen Parameter $true fest, 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsSuperseded
Legen Sie diesen Parameter so $true fest, dass die Ergebnisse nach allen Updates gefiltert werden, die abgelöst werden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsUserDefined
Legen Sie diesen Parameter so $true fest, dass die Ergebnisse nach allen benutzerdefinierten Updates gefiltert werden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Geben Sie den Namen eines Softwareupdates an. Dieser Parameter wird mit dem lokalisierten Anzeigenamenattribut verglichen.
Sie können Platzhalterzeichen verwenden:
*: Mehrere Zeichen?: Einzelnes Zeichen
| Type: | String |
| Aliases: | LocalizedDisplayName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-OnlyExpired
Fügen Sie diesen Parameter hinzu, um nur nach abgelaufenen Softwareupdates zu suchen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Schweregrad
Geben Sie den Schweregrad des Softwareupdates an.
| Type: | CustomSeverityType |
| Accepted values: | None, Low, Moderate, Important, Critical |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateGroup
Geben Sie ein Softwareupdate-Gruppenobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMSoftwareUpdateGroup".
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UpdateGroupId
Geben Sie ein Array von IDs von Softwareupdategruppen an. Dieser Wert ist die CI_ID- oder Konfigurationselement-ID der Softwareupdategruppe. Beispiel: 107078.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateGroupName
Geben Sie ein Array von Namen von Softwareupdategruppen an.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Vendor
Gilt für Version 2010 und höher. Geben Sie den Namen des Softwareupdateanbieters an. Der Anbieter für die meisten Softwareupdates ist "Microsoft" . Wenn Sie Softwareupdates von Drittanbietern konfigurieren, verwenden Sie diesen Wert, um nach anderen Updateanbietern zu filtern.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Server-WMI-Klasse.