Set-CMPackage

SYNOPSIS

Úprava balíčku.

SYNTAX

SetByValue (výchozí)

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

Pomocí této rutiny můžete změnit nastavení balíčku. Další informace najdete v tématu balíčky a programy v Configuration Manager.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: přejmenování balíčku a přidání popisu

Tento příkaz přejmenuje balíček, který má ID ST120001 na ScriptsPackage02 , a přidá popis.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Příklad 2: Změna zdrojové cesty balíčku

První příkaz načte balíček s ID ST120001 a uloží výsledky do proměnné $pkg . Druhý příkaz změní zdrojovou cestu balíčku.

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

PARAMETERS

-Confirm

Přidejte tento parametr pro zobrazení výzvy k potvrzení před spuštěním rutiny.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-CopyToPackageShareOnDistributionPoint

Klienti si můžou vždycky Stáhnout balíček z distribučního bodu. Pokud nastavíte tento parametr na $true, lokalita ji zpřístupní prostřednictvím pojmenované síťové sdílené složky v distribučních bodech. Pomocí CustomPackageShareName zadejte vlastní název sdílené složky.

Pokud povolíte tuto možnost, bude v distribučních bodech vyžadováno více místa. Vztahuje se na všechny distribuční body, do kterých distribuujete tento balíček.

Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CustomPackageShareName

Pokud povolíte CopyToPackageShareOnDistributionPoint, můžete tento parametr použít k přizpůsobení názvu sdílené složky. Maximální délka je 127 znaků a nemůže obsahovat žádný z následujících znaků: " / [ ] : | < > + = ; , ? * . Můžete zadat název sdílené složky a název složky, ale maximum pro každý z nich bude 80 znaků. Například, ShareName\FolderName.

Type: String
Parameter Sets: (All)
Aliases: ShareName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Description

Zadejte volitelný popis balíčku, který vám usnadní jeho identifikaci. Můžete použít maximálně 128 znaků.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisconnectUserFromDistributionPoint

Tato možnost je zastaralá. Nastaví vlastnost ForcedDisconnectEnabled balíčku ovladačů.

Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisconnectUserFromDistributionPointMins

Tato možnost je zastaralá. Nastaví vlastnost ForcedDisconnectDelay balíčku ovladačů.

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

Tato možnost je zastaralá. Nastaví vlastnost ForcedDisconnectNumRetries balíčku ovladačů.

Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPointUpdateSchedule

Pomocí tohoto parametru můžete aktualizovat distribuční body podle plánu. Chcete-li získat objekt plánu, použijte rutinu New-CMSchedule .

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableBinaryDeltaReplication

Nastavte tento parametr na $true , aby se povolila binární rozdílová replikace (binární rozdílová replikace). Další informace najdete v tématu základní koncepty správy obsahu v nástroji Configuration Manager.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– ID

Zadejte ID balíčku, který se má nakonfigurovat. Tato hodnota je standardní ID balíčku, například: XYZ00020 .

Type: String
Parameter Sets: SetById
Aliases: PackageId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Položky InputObject

Zadejte objekt balíčku, který chcete konfigurovat. K získání tohoto objektu použijte rutinu Get-CMPackage .

Type: IResultObject
Parameter Sets: SetByValue
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

– Jazyk

Zadejte řetězec jazyka pro balíček. Ve formátu, který se rozhodnete použít k identifikaci jazykové verze, můžete použít maximálně 32 znaků. Pro identifikaci balíčku Configuration Manager používá parametry jazyka, výrobce, názvu a verze . Můžete mít například anglickou verzi a německou verzi stejného balíčku.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Výrobce

Zadejte název výrobce softwaru. Můžete použít maximálně 32 znaků. Pro identifikaci balíčku Configuration Manager používá parametry jazyka, výrobce, názvu a verze .

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– MifFileName

Zadejte název souboru MIF (Management Information Format), který obsahuje stav balíčku. Přípona názvu souboru musí být .mif . K vygenerování podrobných stavových zpráv o stavu použijte soubor MIF s stavem. Chcete-li vygenerovat soubor MIF stavu, vaše aplikace musí volat funkci InstallStatusMIF. Další informace najdete v tématu stavové funkce MIF.

Nastavíte-li tento parametr, klient Configuration Manager v případě spuštění nasazení vyhledá v %TEMP% adresáři nebo %windir% adresáři pro soubor MIF s stavem instalace, který zadáte. Stav instalace označuje, zda byl program úspěšně spuštěn.

Pokud klient soubor nenajde, vyhledá všechny soubory MIF v těchto adresářích. Nerozlišuje velká a malá písmena u hodnot, které zadáte pro MifName, mifpublisher (vydavatel a MIFVersion ( , do hodnot, které soubor MIF určuje. Pokud klient najde shodu, použije stav, který soubor MIF určí jako stav instalace programu. Pokud nenalezne shodu, nebo pokud nezadáte MifFileName, klient použije ukončovací kód programu k nastavení stavu instalace programu. Ukončovací kód nula znamená, že program byl úspěšně spuštěn. Jakékoli jiné hodnoty označují chybové kódy specifické pro danou aplikaci.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– MifName

Zadejte název balíčku pro párování souborů MIF, maximálně 50 znaků. Další informace najdete v parametru MifFileName .

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Mifpublisher (Vydavatel

Zadejte vydavatele softwaru balíčku pro párování souborů MIF, maximálně 32 znaků. Další informace najdete v parametru MifFileName .

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– MIFVersion (

Zadejte číslo verze balíčku pro párování souborů MIF, maximálně 32 znaků. Další informace najdete v parametru MifFileName .

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MulticastAllow

Nastavením tohoto parametru na $true povolíte přenos tohoto balíčku prostřednictvím vícesměrového vysílání. další informace najdete v tématu použití vícesměrového vysílání k nasazení Windows přes síť s Configuration Manager.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MulticastEncrypt

Pokud povolíte MulticastAllow, nastavte tento parametr na $true k šifrování balíčků vícesměrového vysílání.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MulticastTransferOnly

Pokud povolíte MulticastAllow, nastavte tento parametr tak, aby $true jenom pro přenos tohoto balíčku ovladačů přes vícesměrové vysílání.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Zadejte název balíčku. Můžete použít maximálně 250 znaků. Pro identifikaci balíčku Configuration Manager používá parametry jazyka, výrobce, názvu a verze .

Type: String
Parameter Sets: SetByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewName

Tento parametr použijte k přejmenování balíčku.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– PassThru

Přidejte tento parametr pro vrácení objektu, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Pokud balíček obsahuje zdrojové soubory, zadejte umístění souborů. Můžete zadat úplnou místní cestu na serveru lokality nebo síťovou cestu. Ujistěte se, že toto umístění obsahuje všechny soubory a podadresáře, které program potřebuje ke spuštění, včetně všech skriptů.

Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PersistContentInCache

Pokud nechcete, aby se obsah tohoto balíčku vyčerpal z mezipaměti klienta, aby uvolnil prostor pro další obsah, nastavte tento parametr na $true pro zachování v mezipaměti klienta.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrestageBehavior

Určete chování při povolování distribučního bodu pro připravený obsah:

• ManualCopy: Ručně zkopírovat obsah tohoto balíčku do distribučního bodu
• DownloadDelta: Stahovat do distribučního bodu pouze změny obsahu
• OnDemand: Automaticky stahovat obsah, když jsou balíčky přiřazeny distribučním bodům

Další informace najdete v tématu použití připraveného obsahu.

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

-Priorita

Určete pořadí, ve kterém lokalita odesílá obsah do jiných lokalit a distribučních bodů v této lokalitě.

Lokalita posílá obsah s vysokou prioritou před balíčky s normální nebo nízkou prioritou. Balíčky s totožnou prioritou jsou odesílány v pořadí, ve kterém byly vytvořeny.

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

Pokud chcete povolit distribuci obsahu na vyžádání do upřednostňovaných distribučních bodů, nastavte tento parametr na $true. Pokud povolíte toto nastavení, pokud klient požaduje obsah balíčku a obsah není dostupný v žádných distribučních bodech, bod správy distribuuje obsah. Další informace najdete v tématu distribuce obsahu na vyžádání.

Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Verze

Zadejte číslo verze softwaru. Maximální délka tohoto řetězce je 32 znaků. Pro identifikaci balíčku Configuration Manager používá parametry jazyka, výrobce, názvu a verze .

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement. ManagementProvider. IResultObject

OUTPUTS

System.Object

POZNÁMKY

RELATED LINKS

Export – CMPackage

Get-CMPackage

Import – CMPackage

New-CMPackage

Remove-CMPackage

Balíčky a programy v Configuration Manager