Set-CMPackage
SYNOPSIS
Csomag módosítása.
SYNTAX
SetByValue (alapértelmezett)
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 (Készletazonosító)
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 (Beállítási név)
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
Ezzel a parancsmaggal módosíthatja egy csomag beállításait. További információ: Csomagok és programok a Konfigurációkezelő.
Megjegyzés
Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\>
. További információ: Első lépések.
EXAMPLES
1. példa: Csomag átnevezése és leírás hozzáadása
Ez a parancs átnevezi az ST120001 azonosítójú csomagot ScriptsPackage02 névre, és hozzáad egy leírást.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
2. példa: A csomag forrásútvonalának módosítása
Az első parancs lekérte az ST120001 azonosítójú csomagot, és az eredményeket a $Pkg tárolja. A második parancs módosítja a csomag forrásútvonalát.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
PARAMETERS
-Confirm
Adja hozzá ezt a paramétert, hogy a rendszer megerősítést kér a parancsmag futtatása előtt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
Az ügyfelek mindig letölthetik a csomagokat egy terjesztési pontról. Ha ezt a paramétert a $true, a hely egy elnevezett hálózati megosztáson keresztül teszi elérhetővé a terjesztési pontokon. Egyéni megosztás nevének megadásához használja a CustomPackageShareName nevet.
Ha engedélyezi ezt a beállítást, több helyre van szükség a terjesztési pontokon. Minden olyan terjesztési pontra vonatkozik, amelyre a csomagot terjeszti.
Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Ha engedélyezi a CopyToPackageShareOnDistributionPointot, ezzel a paraméterrel testre szabhatja a megosztás nevét. A maximális hossz 127 karakter, és nem tartalmazhatja a következő karakterek egyikét sem: " / [ ] : | < > + = ; , ? *
. Megadhatja a megosztás és a mappa nevét, de a maximális érték 80 karakter lehet. Például: 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 (Leírás)
Ha szükséges, adjon meg egy leírást a csomaghoz, amely segít az azonosításában. Legfeljebb 128 karaktert használhat.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPoint
Ez a beállítás elavult. Beállítja az illesztőprogram-csomag ForcedDisconnectEnabled tulajdonságát.
Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Ez a beállítás elavult. Beállítja az illesztőprogram-csomag ForcedDisconnectDelay tulajdonságát.
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
Ez a beállítás elavult. Beállítja az illesztőprogram-csomag ForcedDisconnectNumRetries tulajdonságát.
Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Ezzel a paraméterrel ütemezetten frissítheti a terjesztési pontokat. Egy schedule objektum lekért használhatja a New-CMSchedule parancsmagot.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBinaryDeltaReplication
A bináris különbözeti replikáció (BDR$true engedélyezéséhez állítsa be ezt a paramétert. További információ: A tartalomkezelés alapvető fogalmai a Konfigurációkezelő.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). A DisableWildcardHandling használatával nem kombinálható.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id (Azonosító)
Adja meg a konfigurálni kívánt csomag azonosítóját. Ez az érték egy standard csomagazonosító, például: XYZ00020
.
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Adja meg a konfigurálni kívánt csomagobjektumot. Az objektum lekérte a Get-CMPackage parancsmagot.
Type: IResultObject
Parameter Sets: SetByValue
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Language (Nyelv)
Adjon meg egy nyelvi sztringet a csomaghoz. Legfeljebb 32 karakter használható olyan formátumban, amely a nyelvi verzió azonosítására használható. A csomagok azonosításához a Konfigurációkezelő, a Gyártó, a Név és a Verzió paramétereket használja. Például ugyanaz a csomag egy angol és egy német nyelvű verziója is lehet.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Manufacturer (Gyártó)
Adja meg a szoftver gyártójának nevét. Legfeljebb 32 karakter használható. A csomagok azonosításához a Konfigurációkezelő, a Gyártó, a Név és a Verzió paramétereket használja.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifFileName
Adja meg a csomag állapotát tartalmazó Management Information Format (MIF) fájl nevét. A fájlnévkiterjesztésnek a következőnek kell lennie: .mif
. Állapotjelentés készítése állapotjelentések létrehozásához használjon MIF-fájlt. Állapot MIF-fájl létrehozásához az alkalmazásnak meg kell hívnia az InstallStatusMIF függvényt. További információ: Állapot MIF-függvények.
Ha be van állítva ez a paraméter, akkor amikor az ügyfél futtatja a telepítést, a Konfigurációkezelő-ügyfél a megadott telepítési állapotfájlt a könyvtárban vagy a könyvtárban %TEMP%
%windir%
keres. A telepítési állapot azt jelzi, hogy a program sikeresen lefutott-e.
Ha az ügyfél nem találja a fájlt, megkeresi az összes MIF-fájlt az adott könyvtárakban. Ez a mifName, MifPublisher és MifVersion esetében megadott értékek kis- és kis- és összehasonlításaként nem hasonlítja össze a MIF-fájlban megadott értékeket. Ha az ügyfél talál egyezést, a MIF-fájl által a program telepítési állapotaként megadott állapotot használja. Ha nem talál egyezést, vagy ha nem adja meg a MifFileName értéket, az ügyfél a program kilépési kódját használja a program telepítési állapotának beállításhoz. A nulla kilépési kód azt jelzi, hogy a program sikeresen lefutott. Minden más érték alkalmazásspecifikus hibakódokat jelez.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifName
Adja meg a MIF-egyeztetéshez tartozó csomag nevét, amely legfeljebb 50 karakter hosszú lehet. További információ: MifFileName paraméter.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifPublisher
Adja meg a csomag szoftverkiadóját a MIF-egyeztetéshez, legfeljebb 32 karakter hosszú lehet. További információ: MifFileName paraméter.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifVersion
Adja meg a MIF-egyeztetéshez tartozó csomag verziószámát, amely legfeljebb 32 karakter hosszú lehet. További információ: MifFileName paraméter.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastAllow
Állítsa ezt a paramétert $true, hogy a csomag csoportos küldésen keresztül továbbítható legyen. További információ: Csoportosküldés használata Windows hálózaton keresztül a Konfigurációkezelő.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastEncrypt
Ha engedélyezi a MulticastAllow(Csoportos küldés engedélyezése) paramétert, állítsa ezt a paramétert $true csoportos küldési csomagok titkosításához.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastTransferOnly
Ha engedélyezi a MulticastAllow(Csoportos küldés engedélyezése) paramétert, állítsa ezt $true paramétert, hogy csak csoportos küldésen keresztül továbbítsa ezt az illesztőprogram-csomagot.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Adja meg a csomag nevét. Legfeljebb 250 karaktert használhat. A csomag azonosításához a Konfigurációkezelő, a Gyártó, a Név és a Verzió paramétereket használja.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName (Új név)
Ezzel a paraméterrel nevezhet át egy csomagot.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Adja hozzá ezt a paramétert, hogy egy objektumot adjon vissza, amely azt az elemet jelöli, amellyel dolgozik. Alapértelmezés szerint ez a parancsmag nem generál kimenetet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Ha a csomag forrásfájlokat tartalmaz, adja meg a fájlok helyét. Megadhatja a teljes helyi elérési utat a helykiszolgálón, vagy egy hálózati elérési utat. Győződjön meg arról, hogy ez a hely tartalmazza a program által futtatni kívánt összes fájlt és alkönyvtárat, beleértve a parancsfájlokat is.
Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Ha nem szeretné, hogy a csomag tartalma elajátssa az ügyfélgyorsítótárat, hogy helyet adva legyen más tartalmaknak, állítsa $true paraméterre, hogy az ügyfélgyorsítótárban is megmarad.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Adja meg a viselkedést, amikor engedélyezi a terjesztési pontot az előtagként megadott tartalomhoz:
ManualCopy
: A csomag tartalmának manuális másolása a terjesztési pontraDownloadDelta
: Csak a terjesztési pont tartalomváltozásának letöltéseOnDemand
: Tartalom automatikus letöltése, ha a csomagok hozzá vannak rendelve a terjesztési pontokhoz
További információ: Use prestaged content ..
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
-Priority (Prioritás)
Adja meg, hogy a hely milyen sorrendben küldi el a tartalmat a hely más helyeinek és terjesztési pontjainak.
A hely magas prioritású tartalmat küld a normál vagy alacsony prioritású csomagok előtt. Az azonos prioritású csomagok a létrehozásuk sorrendjében vannak elküldve.
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
Ha engedélyezni szeretné az igény szerinti tartalomterjesztést az előnyben részesített terjesztési pontokra, állítsa ezt a paramétert a következőre: $true. Ha engedélyezi ezt a beállítást, és egy ügyfél a csomag tartalmát kéri le, és a tartalom egyetlen terjesztési ponton sem érhető el, akkor a felügyeleti pont terjeszti a tartalmat. További információ: Igény szerinti tartalomterjesztés.
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Version (Verzió)
Adja meg a szoftver verziószámát. A sztring maximális hossza 32 karakter. A csomag azonosításához a Konfigurációkezelő, a Gyártó, a Név és a Verzió paramétereket használja.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.