Set-CMPackage
SYNOPSIS
Bir paketi değiştirin.
SYNTAX
SetByValue (varsayılan)
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>]
Setbyıd
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
Bir paketin ayarlarını değiştirmek için bu cmdlet 'i kullanın. Daha fazla bilgi için bkz. Configuration Manager paket ve programlar.
Not
Örneğin, Configuration Manager site sürücüsünden Configuration Manager cmdlet 'lerini çalıştırın PS XYZ:\>
. Daha fazla bilgi için başlarken bölümüne bakın.
EXAMPLES
Örnek 1: bir paketi yeniden adlandırma ve açıklama ekleme
Bu komut, KIMLIĞI ST120001 olan paketi ScriptsPackage02 olarak yeniden adlandırır ve bir açıklama ekler.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
Örnek 2: paket kaynak yolunu değiştirme
İlk komut, KIMLIĞI ST120001 olan paketi alır ve sonuçları $pkg değişkeninde depolar. İkinci komut, paket kaynak yolunu değiştirir.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
PARAMETERS
-Confirm
Cmdlet çalışmadan önce onay isteyecek şekilde bu parametreyi ekleyin.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-CopyToPackageShareOnDistributionPoint
İstemciler her zaman bir paketi dağıtım noktasından indirebilir. Bu parametreyi $true olarak ayarlarsanız site, dağıtım noktalarında adlandırılmış bir ağ paylaşımından kullanılabilir hale getirir. Özel bir paylaşma adı belirtmek için Custompackagesharename komutunu kullanın.
Bu seçeneği etkinleştirdiğinizde, dağıtım noktalarında daha fazla alan olması gerekir. Bu paketi dağıttığınız tüm dağıtım noktaları için geçerlidir.
Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomPackageShareName
Copytopackageshareondistributionpoint'i etkinleştirirseniz, bu parametreyi, paylaşma adını özelleştirmek için kullanabilirsiniz. Maksimum uzunluk 127 karakterdir ve şu karakterlerden herhangi birini içeremez: " / [ ] : | < > + = ; , ? *
. Bir paylaşma adı ve klasör adı belirtebilirsiniz, ancak her biri için en fazla 80 karakter olabilir. Örneğin, ShareName\FolderName
.
Type: String
Parameter Sets: (All)
Aliases: ShareName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Açıklama
Tanımanıza yardımcı olması için pakete yönelik isteğe bağlı bir açıklama belirtin. En fazla 128 karakter kullanabilirsiniz.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Disableyavaya Cardhandling
Bu parametre, joker karakterleri değişmez değer karakter değerleri olarak değerlendirir. Bunu Forceyavaya Cardhandling ile birleştiremezsiniz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPoint
Bu seçenek kullanım dışıdır. Sürücü paketinin Forceddisconnectenabled özelliğini ayarlar.
Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisconnectUserFromDistributionPointMins
Bu seçenek kullanım dışıdır. Sürücü paketinin Forceddisconnectdelay özelliğini ayarlar.
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
Bu seçenek kullanım dışıdır. Sürücü paketinin Forceddisconnectnumdenemeler özelliğini ayarlar.
Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointUpdateSchedule
Bir zamanlamaya göre dağıtım noktalarını güncelleştirmek için bu parametreyi kullanın. Bir zamanlama nesnesi almak için, New-CMSchedule cmdlet 'ini kullanın.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Enablebinarydeltarizi
İkili değişiklik çoğaltmasını (BDR) etkinleştirmek için bu parametreyi $true olarak ayarlayın. Daha fazla bilgi için bkz. Configuration Manager içerik yönetimi Için temel kavramlar.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Forcebir Cardhandling
Bu parametre joker karakterleri işler ve beklenmeyen davranışlara neden olabilir (önerilmez). Bunu Disableyavaya Cardhandling ile birleştiremezsiniz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ID
Yapılandırılacak paketin KIMLIĞINI belirtin. Bu değer standart bir paket KIMLIĞIDIR, örneğin: XYZ00020
.
Type: String
Parameter Sets: SetById
Aliases: PackageId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Yapılandırılacak bir paket nesnesi belirtin. Bu nesneyi almak için Get-CMPackage cmdlet 'ini kullanın.
Type: IResultObject
Parameter Sets: SetByValue
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Dil
Paket için bir dil dizesi belirtin. Dil sürümünü tanımlamak için kullanmayı seçtiğiniz bir biçimde en fazla 32 karakter kullanabilirsiniz. Bir paketi tanımlamak için Configuration Manager dil, üretici, ad ve Sürüm parametrelerini kullanır. Örneğin, aynı paketin Ingilizce sürümüne ve Almanca sürümüne sahip olabilirsiniz.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Üretici
Yazılım için üretici adını belirtin. En fazla 32 karakter kullanabilirsiniz. Bir paketi tanımlamak için Configuration Manager dil, üretici, ad ve Sürüm parametrelerini kullanır.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifFileName
Paket durumunu içeren yönetim bilgisi biçimi (MIF) dosyasının adını belirtin. Dosya adı uzantısı olmalıdır .mif
. Ayrıntılı durum raporlaması oluşturmak için bir durum MIF dosyası kullanın. Bir durum MIF dosyası oluşturmak için uygulamanızın ınstallstatusmıf işlevini çağırması gerekir. Daha fazla bilgi için bkz. durum MIF işlevleri.
Bu parametreyi ayarlarsanız, istemci dağıtımı çalıştırdığında Configuration Manager istemci, %TEMP%
%windir%
belirttiğiniz yükleme durumu MIF dosyasının dizinine veya dizinine bakar. Yükleme durumu programın başarıyla çalışıp çalışmadığını belirtir.
İstemci dosyayı bulamazsa, bu dizinlerdeki tüm MIF dosyalarını arar. Mifname, mifpublisher ve MIFVERSION için belirttiğiniz değerleri MIF dosyasının belirttiği değerlere büyük/küçük harfe duyarsız bir karşılaştırma yapar. İstemci bir eşleşme bulursa, MIF dosyasının program için yükleme durumu olarak belirttiği durumu kullanır. Bir eşleşme bulamazsa veya Miffilename belirtmezseniz, istemci programın yükleme durumunu ayarlamak için program çıkış kodunu kullanır. Sıfır çıkış kodu programın başarıyla çalıştığını gösterir. Diğer değerler uygulamaya özgü hata kodlarını belirtir.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifName
MIF eşleştirme paketinin adını en fazla 50 karakter belirtin. Daha fazla bilgi için bkz. Miffilename parametresi.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifPublisher
MIF eşleştirme paketinin yazılım yayımcısı 'nı en fazla 32 karakter olacak şekilde belirtin. Daha fazla bilgi için bkz. Miffilename parametresi.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MifVersion
En fazla 32 karakter uzunluğunda olan MIF eşleştirme paketinin sürüm numarasını belirtin. Daha fazla bilgi için bkz. Miffilename parametresi.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastAllow
Bu paketin çok noktaya yayın üzerinden aktarılmasına izin vermek için bu parametreyi $true olarak ayarlayın. daha fazla bilgi için bkz. Configuration Manager ile ağ üzerinden Windows dağıtmak için çok noktaya yayın kullanma.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastEncrypt
MulticastAllow etkinleştirirseniz, çok noktaya yayın paketlerini şifrelemek için bu parametreyi $true olarak ayarlayın.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MulticastTransferOnly
MulticastAllow etkinleştirirseniz, bu parametreyi yalnızca çok noktaya yayın üzerinden aktarmak için $true olarak ayarlayın.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Bir paket adı belirtin. En fazla 250 karakter kullanabilirsiniz. Bir paketi tanımlamak için Yapılandırma Yöneticisi, Üretici, Ad ve Sürüm parametrelerini kullanır.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Paketi yeniden adlandırmak için bu parametreyi kullanın.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Üzerinde çalışmakta olduğunu öğeyi temsil eden bir nesne dönmek için bu parametreyi ekleyin. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Paket kaynak dosyaları içeriyorsa, dosyaların konumunu belirtin. Site sunucusunda tam bir yerel yol veya bir ağ yolu belirtebilirsiniz. Bu konumun, herhangi bir betik de dahil olmak üzere programın çalışması gereken tüm dosyaları ve alt dizinleri içerdiğini emin olun.
Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistContentInCache
Bu paketin içeriğinin diğer içeriğe yer ayarlamak için istemci önbelleğini yaşlarını atlarken bu parametreyi istemci önbelleğinde $true olarak ayarlayın.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestageBehavior
Önceden hazır içerik için bir dağıtım noktasını etkinleştirerek davranışı belirtin:
ManualCopy
: Bu pakette yer alan içeriği dağıtım noktasına el ile kopyalayınDownloadDelta
: Yalnızca içerik değişikliklerini dağıtım noktasına indirmeOnDemand
: Paketler dağıtım noktalarına atandığı zaman içeriği otomatik olarak indirme
Daha fazla bilgi için bkz. Önceden hazır içeriği kullanma.
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
Sitenin içeriği diğer sitelere ve bu sitenin dağıtım noktalarına gönderme sırası belirtin.
Site, normal veya düşük öncelikli paketler öncesinde yüksek öncelikli içerik gönderir. Eşit önceliğe sahip paketler, oluşturuldukları sırayla gönderilir.
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
Tercih edilen dağıtım noktalarına isteğe bağlı içerik dağıtımını etkinleştirmek için bu parametreyi $true. Bu ayarı etkinleştirseniz, istemci paket için içerik isteğinde bulunuyorsa ve içerik herhangi bir dağıtım noktasında mevcut değilse, yönetim noktası içeriği dağıtır. Daha fazla bilgi için bkz. isteğe bağlı içerik dağıtımı.
Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Version
Yazılım için bir sürüm numarası belirtin. Bu dizenin uzunluk üst uzunluğu 32 karakterdir. Bir paketi tanımlamak için Yapılandırma Yöneticisi, Üretici, Ad ve Sürüm parametrelerini kullanır.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalışmaz.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Bu cmdlet şu genel parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.