Delen via


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.

Get-CMSoftwareUpdateGroup

Save-CMSoftwareUpdate

Set-CMSoftwareUpdate

Sync-CMSoftwareUpdate

Get-CMSoftwareUpdateCategory

Get-CMSoftwareUpdateGroup

Get-CMSoftwareUpdateContentInfo