Set-CMPackage
Ändern eines Pakets.
Syntax
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>]
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>]
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>]
Beschreibung
Verwenden Sie dieses Cmdlet, um die Einstellungen eines Pakets zu ändern. Weitere Informationen finden Sie unter Pakete und Programme in Configuration Manager.
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: Umbenennen eines Pakets und Hinzufügen einer Beschreibung
Mit diesem Befehl wird das Paket mit der ID ST120001 in ScriptsPackage02 umbenannt und eine Beschreibung hinzugefügt.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
Beispiel 2: Ändern des Paketquellpfads
Der erste Befehl ruft das Paket mit der ID ST120001ab und speichert die Ergebnisse in der variablen $Pkg. Der zweite Befehl ändert den Paketquellpfad.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
Parameter
-Confirm
Fügen Sie diesen Parameter hinzu, um zur Bestätigung aufzufordern, bevor das Cmdlet ausgeführt wird.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
Clients können ein Paket immer von einem Verteilungspunkt herunterladen. Wenn Sie diesen Parameter auf $truefestlegen, stellt der Standort ihn über eine benannte Netzwerkfreigabe an Verteilungspunkten zur Verfügung. Verwenden Sie CustomPackageShareName, um einen benutzerdefinierten Freigabenamen anzugeben.
Wenn Sie diese Option aktivieren, ist mehr Speicherplatz für Verteilungspunkte erforderlich. Sie gilt für alle Verteilungspunkte, an die Sie dieses Paket verteilen.
Type: | Boolean |
Aliases: | ShareContent, CopyToPackageShareOnDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomPackageShareName
Wenn Sie CopyToPackageShareOnDistributionPointaktivieren, können Sie diesen Parameter verwenden, um den Freigabenamen anzupassen. Die maximale Länge beträgt 127 Zeichen und kann keines der folgenden Zeichen enthalten: " / [ ] : | < > + = ; , ? *
. Sie können einen Freigabenamen und einen Ordnernamen angeben, aber dann beträgt das Maximum 80 Zeichen. Beispiel: ShareName\FolderName
.
Type: | String |
Aliases: | ShareName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Geben Sie eine optionale Beschreibung des Pakets an, um es zu identifizieren. Sie können maximal 128 Zeichen verwenden.
Type: | String |
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 |
-DisconnectUserFromDistributionPoint
Diese Option ist veraltet. Sie legt die ForcedDisconnectEnabled-Eigenschaft des Treiberpakets fest.
Type: | Boolean |
Aliases: | ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
Diese Option ist veraltet. Sie legt die ForcedDisconnectDelay-Eigenschaft des Treiberpakets fest.
Type: | UInt32 |
Aliases: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetry
Diese Option ist veraltet. Sie legt die ForcedDisconnectNumRetries-Eigenschaft des Treiberpakets fest.
Type: | UInt32 |
Aliases: | ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
Verwenden Sie diesen Parameter, um Verteilungspunkte nach einem Zeitplan zu aktualisieren. Verwenden Sie zum Abrufen eines Zeitplanobjekts das Cmdlet "New-CMSchedule".
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
Legen Sie diesen Parameter auf $true fest, um die binäre Differenzielle Replikation (Binary Differential Replication, BDR) zu aktivieren. Weitere Informationen finden Sie unter grundlegende Konzepte für die Inhaltsverwaltung in Configuration Manager.
Type: | Boolean |
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
Geben Sie die ID eines zu konfigurierenden Pakets an. Dieser Wert ist eine Standardpaket-ID, z. B.: XYZ00020
.
Type: | String |
Aliases: | PackageId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geben Sie ein zu konfigurierende Paketobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMPackage".
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Language
Geben Sie eine Sprachzeichenfolge für das Paket an. Sie können maximal 32 Zeichen in einem Format verwenden, das Sie zur Identifizierung der Sprachversion verwenden möchten. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter "Language", "Manufacturer", "Name" und "Version". Sie können z. B. eine englische und eine deutsche Version desselben Pakets verwenden.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Manufacturer
Geben Sie den Herstellernamen für die Software an. Sie können maximal 32 Zeichen verwenden. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter "Language", "Manufacturer", "Name" und "Version".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifFileName
Geben Sie den Namen der MIF-Datei (Management Information Format) an, die den Paketstatus enthält. Die Dateinamenerweiterung muss .mif
. Verwenden Sie eine Status-MIF-Datei, um detaillierte Statusberichte zu generieren. Um eine Status-MIF-Datei zu generieren, muss die Anwendung die InstallStatusMIF-Funktion aufrufen. Weitere Informationen finden Sie unter Status MIF Functions.
Wenn Sie diesen Parameter festlegen, sucht der Configuration Manager-Client beim Ausführen der Bereitstellung im Verzeichnis oder im Verzeichnis nach %TEMP%
%windir%
der MIF-Datei für den Installationsstatus, die Sie angeben. Der Installationsstatus gibt an, ob das Programm erfolgreich ausgeführt wurde.
Wenn der Client die Datei nicht findet, sucht er nach allen MIF-Dateien in diesen Verzeichnissen. Es wird ein Vergleich der Werte, die Sie für MifName, MifPublisherund MifVersion angeben, mit den Werten, die in der MIF-Datei angegeben sind, ohne Groß-/Kleinschreibung durchgeführt. Wenn der Client eine Übereinstimmung findet, verwendet er den Status, den die MIF-Datei als Installationsstatus für das Programm angibt. Wenn keine Übereinstimmung gefunden werden kann oder Wenn Sie MifFileNamenicht angeben, verwendet der Client den Programm-Exitcode, um den Installationsstatus für das Programm festzulegen. Der Exitcode 0 gibt an, dass das Programm erfolgreich ausgeführt wurde. Alle anderen Werte weisen auf anwendungsspezifische Fehlercodes hin.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifName
Geben Sie den Namen des Pakets für den MIF-Abgleich an, bis zu 50 Zeichen. Weitere Informationen finden Sie unter dem Parameter "MifFileName".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifPublisher
Geben Sie den Softwareherausgeber des Pakets für den MIF-Abgleich an, bis zu 32 Zeichen. Weitere Informationen finden Sie unter dem Parameter "MifFileName".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifVersion
Geben Sie die Versionsnummer des Pakets für den MIF-Abgleich an, bis zu 32 Zeichen. Weitere Informationen finden Sie unter dem Parameter "MifFileName".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MulticastAllow
Legen Sie diesen Parameter auf $true fest, damit dieses Paket über Multicast übertragen werden kann. Weitere Informationen finden Sie unter Verwenden von Multicast zum Bereitstellen von Windows über das Netzwerk mit Configuration Manager.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MulticastEncrypt
Wenn Sie MulticastAllowaktivieren, legen Sie diesen Parameter auf $true fest, um Multicastpakete zu verschlüsseln.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MulticastTransferOnly
Wenn Sie MulticastAllowaktivieren, legen Sie diesen Parameter auf $true fest, um dieses Treiberpaket nur über Multicast zu übertragen.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Geben Sie einen Paketnamen an. Sie können maximal 250 Zeichen verwenden. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter "Language", "Manufacturer", "Name" und "Version".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Verwenden Sie diesen Parameter, um ein Paket umzubenennen.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Wenn das Paket Quelldateien enthält, geben Sie den Speicherort der Dateien an. Sie können entweder einen vollständigen lokalen Pfad auf dem Standortserver oder einen Netzwerkpfad angeben. Stellen Sie sicher, dass dieser Speicherort alle Dateien und Unterverzeichnisse enthält, die das Programm ausführen muss, einschließlich aller Skripts.
Type: | String |
Aliases: | PackageSourcePath |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistContentInCache
Wenn Sie nicht möchten, dass der Inhalt dieses Pakets aus dem Clientcache überaltert wird, um Platz für andere Inhalte zu schaffen, legen Sie diesen Parameter auf $true fest, um ihn im Clientcache zu speichern.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrestageBehavior
Geben Sie das Verhalten an, wenn Sie einen Verteilungspunkt für Vorabinhalte aktivieren:
ManualCopy
: Manuelles Kopieren des Inhalts in diesem Paket an den VerteilungspunktDownloadDelta
: Nur Inhaltsänderungen an den Verteilungspunkt herunterladenOnDemand
: Inhalte automatisch herunterladen, wenn Pakete Verteilungspunkten zugewiesen sind
Weitere Informationen finden Sie unter Verwenden vorab verwendeter Inhalte.
Type: | PrestageBehavior |
Accepted values: | ManualCopy, DownloadDelta, OnDemand |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Priority
Geben Sie die Reihenfolge an, in der die Website den Inhalt an andere Websites und die Verteilungspunkte auf dieser Website sendet.
Die Website sendet Inhalte mit hoher Priorität vor Paketen mit normaler oder niedriger Priorität. Pakete mit gleicher Priorität werden in der Reihenfolge gesendet, in der sie erstellt werden.
Type: | Priorities |
Aliases: | DistributionPriority |
Accepted values: | High, Normal, Low |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
Wenn Sie die On-Demand-Inhaltsverteilung auf bevorzugte Verteilungspunkte aktivieren möchten, legen Sie diesen Parameter auf $truefest. Wenn Sie diese Einstellung aktivieren und ein Client den Inhalt für das Paket anfordert und der Inhalt an keinen Verteilungspunkten verfügbar ist, verteilt der Verwaltungspunkt den Inhalt. Weitere Informationen finden Sie unter On-Demand Content Distribution.
Type: | Boolean |
Aliases: | SendToPreferredDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
Geben Sie eine Versionsnummer für die Software an. Die maximale Länge dieser Zeichenfolge beträgt 32 Zeichen. Um ein Paket zu identifizieren, verwendet Configuration Manager die Parameter "Language", "Manufacturer", "Name" und "Version".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object