Set-CMPackage
SYNOPSIS
Ändra ett paket.
SYNTAX
SetByValue (standard)
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
Använd den här cmdleten för att ändra inställningarna för ett paket. Mer information finns i Paket och program i Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Byt namn på ett paket och lägg till en beskrivning
Det här kommandot byter namn på paketet som har ID:t ST120001 till ScriptsPackage02 och lägger till en beskrivning.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
Exempel 2: Ändra paketkällsökvägen
Det första kommandot hämtar paketet som har ID:t ST120001 och lagrar resultatet i $Pkg variabeln. Det andra kommandot ändrar paketkällsökvägen.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
PARAMETERS
-Confirm
Lägg till den här parametern för att be om bekräftelse innan cmdleten körs.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
Klienter kan alltid ladda ned ett paket från en distributionsplats. Om du anger den här parametern $true, gör platsen den tillgänglig via en namngiven nätverksresurs på distributionsplatser. Använd CustomPackageShareName för att ange ett anpassat resursnamn.
När du aktiverar det här alternativet krävs mer utrymme på distributionsplatser. Det gäller för alla distributionsplatser som du distribuerar det här paketet till.
Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Om du aktiverar CopyToPackageShareOnDistributionPoint kan du använda den här parametern för att anpassa resursnamnet. Den maximala längden är 127 tecken och får inte innehålla något av följande tecken: " / [ ] : | < > + = ; , ? * . Du kan ange ett resursnamn och ett mappnamn, men maxvärdet för var och en är 80 tecken. Till exempel ShareName\FolderName.
Type: String
Parameter Sets: (All)
Aliases: ShareName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beskrivning
Ange en valfri beskrivning av paketet som hjälper dig att identifiera det. Du kan använda högst 128 tecken.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPoint
Det här alternativet är inaktuellt. Den anger egenskapen ForcedDisconnectEnabled för drivrutinspaketet.
Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Det här alternativet är inaktuellt. Den anger egenskapen ForcedDisconnectDelay för drivrutinspaketet.
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
Det här alternativet är inaktuellt. Den anger egenskapen ForcedDisconnectNumRetries för drivrutinspaketet.
Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Använd den här parametern för att uppdatera distributionsplatser enligt ett schema. Om du vill hämta ett schemaobjekt använder du cmdleten New-CMSchedule.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBinaryDeltaReplication
Ange den här parametern $true aktivera binär differentiell replikering (BDR). Mer information finns i Grundläggande begrepp för innehållshantering i Konfigurationshanteraren.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Ange ID för ett paket som ska konfigureras. Det här värdet är ett standardpaket-ID, till exempel: XYZ00020 .
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett paketobjekt som ska konfigureras. Hämta det här objektet med cmdleten Get-CMPackage.
Type: IResultObject
Parameter Sets: SetByValue
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Language
Ange en språksträng för paketet. Du kan använda högst 32 tecken i ett format som du väljer att använda för att identifiera språkversionen. För att identifiera ett Konfigurationshanteraren använder parametrarna Språk, Tillverkare, Namn och Version. Du kan till exempel ha en engelsk version och en tysk version av samma paket.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Tillverkare
Ange tillverkarens namn på programvaran. Använd högst 32 tecken. För att identifiera ett Konfigurationshanteraren använder parametrarna Språk, Tillverkare, Namn och Version.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifFileName
Ange namnet på MIF-filen (Management Information Format) som innehåller paketstatusen. Filnamnstillägget måste vara .mif . Använd en MIF-statusfil för att generera detaljerad statusrapportering. Om du vill generera en MIF-statusfil måste programmet anropa funktionen InstallStatusMIF. Mer information finns i Status MIF Functions.
Om du anger den här parametern letar Konfigurationshanteraren-klienten i katalogen eller katalogen efter den %TEMP% MIF-installationsstatusfil som du anger när klienten %windir% kör distributionen. Installationsstatusen anger om programmet har körts.
Om klienten inte hittar filen söker den efter alla MIF-filer i dessa kataloger. Den gör en okänslig jämförelse av de värden som du anger för MifName, MifPublisher och MifVersion med de värden som MIF-filen anger. Om klienten hittar en matchning används den status som MIF-filen anger som installationsstatus för programmet. Om det inte går att hitta någon matchning, eller om du inte anger MifFileName, använder klienten programmets slutkod för att ange installationsstatus för programmet. Slutkoden noll anger att programmet har körts. Alla andra värden anger programspecifika felkoder.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifName
Ange namnet på paketet för MIF-matchning, upp till 50 tecken. Mer information finns i parametern MifFileName.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifPublisher
Ange programvaruutgivaren av paketet för MIF-matchning, upp till 32 tecken. Mer information finns i parametern MifFileName.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifVersion
Ange paketets versionsnummer för MIF-matchning, upp till 32 tecken. Mer information finns i parametern MifFileName.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastAllow
Ange den här parametern $true att tillåta att det här paketet överförs via multicast. Mer information finns i Använda multicast för att Windows över nätverket med Konfigurationshanteraren.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastEncrypt
Om du aktiverar MulticastAllow anger du den här parametern till $true krypterar multicast-paket.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastTransferOnly
Om du aktiverar MulticastAllow anger du den här parametern till $true att endast överföra det här drivrutinspaketet via multicast.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Ange ett paketnamn. Du kan använda högst 250 tecken. För att identifiera ett Konfigurationshanteraren använder parametrarna Språk, Tillverkare, Namn och Version.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Använd den här parametern för att byta namn på ett paket.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Om paketet innehåller källfiler anger du platsen för filerna. Du kan ange antingen en fullständig lokal sökväg på platsservern eller en nätverkssökväg. Kontrollera att den här platsen innehåller alla filer och underkataloger som programmet behöver köra, inklusive eventuella skript.
Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Om du inte vill att innehållet i det här paketet ska bli äldre än klientcachen för att göra plats för annat innehåll anger du den här parametern till $true att spara den i klientcachen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Ange beteendet när du aktiverar en distributionsplats för förinstallerat innehåll:
ManualCopy: Kopiera innehållet i det här paketet manuellt till distributionsplatsenDownloadDelta: Hämta endast innehållsändringar till distributionsplatsenOnDemand: Hämta innehåll automatiskt när paket tilldelas till distributionsplatser
Mer information finns i Använda förinstallerat innehåll.
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
-Prioritet
Ange i vilken ordning webbplatsen skickar innehållet till andra platser och distributionsplatserna på den här platsen.
Webbplatsen skickar innehåll med hög prioritet före paket med normal eller låg prioritet. Paket med samma prioritet skickas i den ordning som de skapas.
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
Om du vill aktivera innehållsdistribution på begäran till prioriterade distributionsplatser anger du den här parametern till $true. När du aktiverar den här inställningen, om en klient begär innehållet för paketet och innehållet inte är tillgängligt på några distributionsplatser, distribuerar hanteringsplatsen innehållet. Mer information finns i Innehållsdistribution på begäran.
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Version
Ange ett versionsnummer för programvaran. Den maximala längden för den här strängen är 32 tecken. För att identifiera ett Konfigurationshanteraren använder parametrarna Språk, Tillverkare, Namn och Version.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.