Aracılığıyla paylaş


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ın
  • DownloadDelta: Yalnızca içerik değişikliklerini dağıtım noktasına indirme
  • OnDemand: 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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

NOTLAR

Export-CMPackage

Get-CMPackage

Import-CMPackage

New-CMPackage

Remove-CMPackage

Yapılandırma Yöneticisi'da paketler ve programlar