Get-CMSoftwareUpdate
SYNOPSIS
Een software-update downloaden.
SYNTAX
SearchByName (standaard)
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>]
SearchById
Get-CMSoftwareUpdate [-Fast] -Id <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroup
Get-CMSoftwareUpdate [-Fast] -UpdateGroup <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroupIdMandatory
Get-CMSoftwareUpdate [-Fast] -UpdateGroupId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroupNameMandatory
Get-CMSoftwareUpdate [-Fast] -UpdateGroupName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
Gebruik deze cmdlet om een of meer software-updates op te halen.
Zie Documentatie voor software-updatebeheer in de basisdocumenten voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Gedownloade software-updates downloaden
Met deze opdracht worden alle software-updates die de site heeft gedownload, gedownload.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Voorbeeld 2: Software-updates per updategroep downloaden
Met deze opdracht wordt eerst het software-updategroepobject met de naam TestSUgroup10. Vervolgens wordt de pijplijnoperator gebruikt om het object door te geven aan Get-CMSoftwareUpdate. Het resultaat is de lijst met alle software-updates voor de software-updategroep.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate
PARAMETERS
-ArticleId
Geef de artikel-id van een software-update op. Bijvoorbeeld 4571687.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-BulletinId
Geef de bulletin-id van een software-update op. Bijvoorbeeld MS18-952.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Category
Geef de categorie van een software-update op. Gebruik de cmdlet Get-CMSoftwareUpdateCategory om een categorieobject op te halen.
Type: IResultObject[]
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-CategoryName
Geef een matrix met categorienamen op voor software-updates.
Type: String[]
Parameter Sets: SearchByName
Aliases: CategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMax
Geef de laatste datum op waarop een software-update is uitgebracht.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DatePostedMin
Geef de vroegste datum op waarop een software-update is uitgebracht.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateRevisedMax
Geef de meest recente datum op waarop een software-update is herzien.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DateRevisedMin
Geef de vroegste datum op waarop een software-update is herzien.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EulaExist
Stel deze parameter in op $true om de resultaten te filteren voor alle updates die een licentieovereenkomst hebben.
Type: Boolean
Parameter Sets: SearchByName
Aliases: EulaExists
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fast
Voeg deze parameter toe om luie eigenschappen niet automatisch te vernieuwen. Luie eigenschappen bevatten waarden die relatief inefficiënt zijn om op te halen. Het verkrijgen van deze eigenschappen kan extra netwerkverkeer veroorzaken en de prestaties van de cmdlet verlagen.
Als u deze parameter niet gebruikt, geeft de cmdlet een waarschuwing weer. Als u deze waarschuwing wilt uitschakelen, stelt u $CMPSSuppressFastNotUsedCheck = $true in.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Hiermee geeft u de id van een software-update op. Deze waarde is de CI_ID, bijvoorbeeld 143404 .
Type: Int32
Parameter Sets: SearchById
Aliases: CIId, CI_ID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeUpgrade
Voeg deze parameter toe om software-updates op te nemen in de upgradecategorie.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases: IncludeUpgrades
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsContentProvisioned
Stel deze parameter in $true op om de resultaten te filteren voor alle updates waarvoor de site inhoud heeft gedownload.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsDeployed
Stel deze parameter in $true op om de resultaten te filteren voor alle updates die zijn geïmplementeerd.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsExpired
Stel deze parameter in op $true om de resultaten te filteren voor alle updates die zijn verlopen.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsLatest
Stel deze parameter in op om de resultaten voor de nieuwste versie van de $true software-update te filteren.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsOfflineServiceable
Stel deze parameter in op $true om de resultaten te filteren voor alle updates die offline kunnen worden gebruikt. U kunt het opdrachtregelprogramma DISM gebruiken om deze updates in een besturingssysteemafbeelding te injecteren.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsSuperseded
Stel deze parameter in $true op om de resultaten te filteren voor alle updates die worden vervangen.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsUserDefined
Stel deze parameter in op $true om de resultaten te filteren voor alle updates die door de gebruiker zijn gedefinieerd.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Geef de naam van een software-update op. Deze parameter wordt vergeleken met het kenmerk gelokaliseerde weergavenaam.
U kunt jokertekens gebruiken:
*: Meerdere tekens?: Eén teken
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-OnlyExpired
Voeg deze parameter toe om alleen te zoeken naar verlopen software-updates.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ernst
Geef de ernst van de software-update op.
Type: CustomSeverityType
Parameter Sets: SearchByName
Aliases:
Accepted values: None, Low, Moderate, Important, Critical
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroup
Geef het software-updategroepobject op. Gebruik de cmdlet Get-CMSoftwareUpdateGroup om dit object op te halen.
Type: IResultObject
Parameter Sets: SearchByUpdateGroup
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-UpdateGroupId
Geef een matrix met ID's van software-updategroepen op. Deze waarde is de CI_ID-id of configuratie-item van de software-updategroep. Bijvoorbeeld 107078.
Type: String[]
Parameter Sets: SearchByUpdateGroupIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroupName
Geef een matrix met namen van software-updategroepen op.
Type: String[]
Parameter Sets: SearchByUpdateGroupNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Vendor
Is van toepassing op versie 2010 en hoger. Geef de naam op van de leverancier van de software-update. De leverancier voor de meeste software-updates is "Microsoft" . Als u software-updates van derden configureert, gebruikt u deze waarde om te filteren op andere updateleveranciers.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_SoftwareUpdate
IResultObject#SMS_SoftwareUpdate
OPMERKINGEN
Zie WMI-klasse SMS_SoftwareUpdate server voor meer informatie over dit retourobject en deeigenschappen ervan.