Set-CMPackage
SYNOPSIS
Een pakket wijzigen.
SYNTAX
SetByValue (standaard)
Set-CMPackage [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
[-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>]
[-InputObject] <IResultObject> [-Language <String>] [-Manufacturer <String>] [-MifFileName <String>]
[-MifName <String>] [-MifPublisher <String>] [-MifVersion <String>] [-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>] [-MulticastTransferOnly <Boolean>] [-NewName <String>] [-PassThru]
[-Path <String>] [-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>] [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetById
Set-CMPackage [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
[-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>] -Id <String>
[-Language <String>] [-Manufacturer <String>] [-MifFileName <String>] [-MifName <String>]
[-MifPublisher <String>] [-MifVersion <String>] [-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>] [-NewName <String>] [-PassThru] [-Path <String>]
[-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>] [-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetByName
Set-CMPackage [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
[-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>]
[-Language <String>] [-Manufacturer <String>] [-MifFileName <String>] [-MifName <String>]
[-MifPublisher <String>] [-MifVersion <String>] [-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>] -Name <String> [-NewName <String>] [-PassThru] [-Path <String>]
[-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>] [-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Gebruik deze cmdlet om de instellingen van een pakket te wijzigen. Zie Pakketten en programma's in Configuration Manager.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: De naam van een pakket wijzigen en een beschrijving toevoegen
Met deze opdracht wijzigt u de naam van het pakket met de id ST120001 in ScriptsPackage02 en wordt een beschrijving toegevoegd.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
Voorbeeld 2: het bronpad van het pakket wijzigen
De eerste opdracht haalt het pakket met de id ST120001 op en slaat de resultaten op in de $Pkg variabele. Met de tweede opdracht wordt het bronpad van het pakket gewijzigd.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
PARAMETERS
-Confirm
Voeg deze parameter toe om te vragen om bevestiging voordat de cmdlet wordt uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
Clients kunnen altijd een pakket downloaden van een distributiepunt. Als u deze parameter in $true, maakt de site deze beschikbaar via een benoemde netwerk share op distributiepunten. Gebruik CustomPackageShareName om een aangepaste sharenaam op te geven.
Wanneer u deze optie inschakelen, is meer ruimte vereist op distributiepunten. Het is van toepassing op alle distributiepunten waarop u dit pakket distribueert.
Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Als u CopyToPackageShareOnDistributionPoint inschakelen, kunt u deze parameter gebruiken om de sharenaam aan te passen. De maximale lengte is 127 tekens en mag geen van de volgende tekens bevatten: " / [ ] : | < > + = ; , ? * . U kunt een sharenaam en mapnaam opgeven, maar het maximum voor elk bestand is 80 tekens. Bijvoorbeeld ShareName\FolderName.
Type: String
Parameter Sets: (All)
Aliases: ShareName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beschrijving
Geef een optionele beschrijving van het pakket op om het te identificeren. U kunt maximaal 128 tekens gebruiken.
Type: String
Parameter Sets: (All)
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
-DisconnectUserFromDistributionPoint
Deze optie is afgeschaft. Hiermee stelt u de eigenschap ForcedDisconnectEnabled van het stuurprogrammapakket in.
Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Deze optie is afgeschaft. Hiermee stelt u de eigenschap ForcedDisconnectDelay van het stuurprogrammapakket in.
Type: UInt32
Parameter Sets: (All)
Aliases: ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointRetry
Deze optie is afgeschaft. Hiermee stelt u de eigenschap ForcedDisconnectNumRetries van het stuurprogrammapakket in.
Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Gebruik deze parameter om distributiepunten volgens een schema bij te werken. Gebruik de cmdlet New-CMSchedule om een schemaobject op te halen.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBinaryDeltaReplication
Stel deze parameter in op $true binaire differentiële replicatie (BDR) in teschakelen. Zie Basisconcepten voor inhoudsbeheer inConfiguration Manager.
Type: Boolean
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
Geef de id op van een pakket dat u wilt configureren. Deze waarde is een standaard pakket-id, bijvoorbeeld: XYZ00020 .
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een pakketobject op dat moet worden geconfigureerd. Gebruik de cmdlet Get-CMPackage om dit object op te halen.
Type: IResultObject
Parameter Sets: SetByValue
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Language
Geef een taalreeks op voor het pakket. U kunt maximaal 32 tekens gebruiken in een indeling die u wilt gebruiken om de taalversie te identificeren. Als u een pakket wilt identificeren, Configuration Manager de parameters Language, Manufacturer, Name en Version gebruikt. U kunt bijvoorbeeld een Engelse versie en een Duitse versie van hetzelfde pakket hebben.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fabrikant
Geef de naam van de fabrikant voor de software op. U kunt maximaal 32 tekens gebruiken. Als u een pakket wilt identificeren, Configuration Manager de parameters Language, Manufacturer, Name en Version gebruikt.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifFileName
Geef de naam op van het MIF-bestand (Management Information Format) dat de pakketstatus bevat. De bestandsnaamextensie moet .mif zijn. Gebruik een MIF-statusbestand om gedetailleerde statusrapportage te genereren. Als u een MIF-statusbestand wilt genereren, moet uw toepassing de functie InstallStatusMIF aanroepen. Zie Status MIF Functions voor meer informatie.
Als u deze parameter in stelt wanneer de client de implementatie wordt uitgevoerd, zoekt de Configuration Manager-client in de map of de map voor het MIF-bestand met de installatiestatus dat %TEMP% %windir% u opgeeft. De installatiestatus geeft aan of het programma is uitgevoerd.
Als de client het bestand niet vindt, zoekt deze naar alle MIF-bestanden in deze mappen. Hiermee wordt een niet-casegevoelige vergelijking gemaakt van de waarden die u opgeeft voor MifName, MifPublisher en MifVersion met de waarden die het MIF-bestand opgeeft. Als de client een overeenkomst vindt, wordt de status gebruikt die door het MIF-bestand wordt opgegeven als de installatiestatus voor het programma. Als er geen overeenkomst kan worden gevonden of als u MifFileName niet opgeeft, gebruikt de client de programma-exitcode om de installatiestatus voor het programma in te stellen. Een afsluitende code van nul geeft aan dat het programma is uitgevoerd. Andere waarden geven toepassingsspecifieke foutcodes aan.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifName
Geef de naam op van het pakket voor MIF-matching, maximaal 50 tekens. Zie de parameter MifFileName voor meer informatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifPublisher
Geef de software-uitgever van het pakket voor MIF-matching op, maximaal 32 tekens. Zie de parameter MifFileName voor meer informatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifVersion
Geef het versienummer van het pakket voor MIF-matching op, maximaal 32 tekens. Zie de parameter MifFileName voor meer informatie.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastAllow
Stel deze parameter in op $true zodat dit pakket kan worden overgedragen via multicast. Zie Use multicast to deploy Windows over the network with Configuration Manager (Multicastgebruiken voor het implementeren van Windows via het netwerk met Configuration Manager.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastEncrypt
Als u MulticastAllow inschakelen, stelt u deze parameter in op $true multicast-pakketten te versleutelen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastTransferOnly
Als u MulticastAllow inschakelen, stelt u deze parameter in op $true dit stuurprogrammapakket alleen via multicast over te dragen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Geef een pakketnaam op. U kunt maximaal 250 tekens gebruiken. Als u een pakket wilt identificeren, Configuration Manager de parameters Language, Manufacturer, Name en Version gebruikt.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Gebruik deze parameter om de naam van een pakket te wijzigen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Als het pakket bronbestanden bevat, geeft u de locatie van de bestanden op. U kunt een volledig lokaal pad op de siteserver of een netwerkpad opgeven. Zorg ervoor dat deze locatie alle bestanden en subdirecties bevat die het programma moet uitvoeren, inclusief eventuele scripts.
Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Als u niet wilt dat de inhoud van dit pakket uit de clientcache wordt verwijderd om ruimte te maken voor andere inhoud, stelt u deze parameter in op $true om deze in de clientcache te houden.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Geef het gedrag op wanneer u een distributiepunt inschakelen voor voorgefaseerd inhoud:
ManualCopy: Kopieer de inhoud in dit pakket handmatig naar het distributiepuntDownloadDelta: Alleen inhoudswijzigingen downloaden naar het distributiepuntOnDemand: inhoud automatisch downloaden wanneer pakketten worden toegewezen aan distributiepunten
Zie Voorgefaseerd inhoud gebruiken voor meer informatie.
Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Prioriteit
Geef de volgorde op waarin de site de inhoud naar andere sites en de distributiepunten op deze site verzendt.
De site verzendt inhoud met hoge prioriteit vóór pakketten met een normale of lage prioriteit. Pakketten met gelijke prioriteit worden verzonden in de volgorde waarin ze worden gemaakt.
Type: Priorities
Parameter Sets: (All)
Aliases: DistributionPriority
Accepted values: High, Normal, Low
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendToPreferredDistributionPoint
Als u inhoudsdistributie op aanvraag naar voorkeursdistributiepunten wilt inschakelen, stelt u deze parameter in op $true. Wanneer u deze instelling inschakelen, als een client de inhoud voor het pakket aanvraagt en de inhoud niet beschikbaar is op distributiepunten, distribueert het beheerpunt de inhoud. Zie Inhoudsdistributie op aanvraag voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Versie
Geef een versienummer op voor de software. De maximale lengte van deze tekenreeks is 32 tekens. Als u een pakket wilt identificeren, Configuration Manager de parameters Language, Manufacturer, Name en Version gebruikt.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
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.