New-CMSoftwareUpdatePhase

Makale
08/12/2021

SYNOPSIS

Yazılım güncelleştirmesi için dağıtım aşaması oluşturmak üzere bu cmdlet'i kullanın.

SYNTAX

SearchByCollection

New-CMSoftwareUpdatePhase [-AlertDelta <Int32>] [-AlertThresholdPercentage <Int32>] [-AlertUnit <TimeUnitType>]
 [-AllowMeteredConnection <Boolean>] [-AllowSystemRestart <Boolean>] [-AllowWumuFallback <Boolean>]
 [-BeginCondition <BeginConditionType>] [-Collection] <IResultObject> [-CriteriaOption <CriteriaType>]
 [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>]
 [-DeadlineValue <Int32>] [-DisableScomAlert <Boolean>] [-EnableAlert <Boolean>] [-EnableWakeOnLan <Boolean>]
 [-GenerateScomAlertOnFailure <Boolean>] [-InstallationChoice <InstallationChoiceType>]
 [-PhaseDescription <String>] -PhaseName <String> [-RequirePostRebootFullScan <Boolean>]
 [-ServerRestartSuppression <Boolean>] [-SoftwareInstallation <Boolean>]
 [-StateMessageVerbosity <VerbosityLevelType>] [-ThrottlingDays <Int32>] [-UseNeighborDP <Boolean>]
 [-UserNotificationOption <UserNotificationType>] [-UseSiteDefaultDP <Boolean>]
 [-WorkstationRestartSuppression <Boolean>] [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByCollectionId

New-CMSoftwareUpdatePhase [-AlertDelta <Int32>] [-AlertThresholdPercentage <Int32>] [-AlertUnit <TimeUnitType>]
 [-AllowMeteredConnection <Boolean>] [-AllowSystemRestart <Boolean>] [-AllowWumuFallback <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionId] <String> [-CriteriaOption <CriteriaType>]
 [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>]
 [-DeadlineValue <Int32>] [-DisableScomAlert <Boolean>] [-EnableAlert <Boolean>] [-EnableWakeOnLan <Boolean>]
 [-GenerateScomAlertOnFailure <Boolean>] [-InstallationChoice <InstallationChoiceType>]
 [-PhaseDescription <String>] -PhaseName <String> [-RequirePostRebootFullScan <Boolean>]
 [-ServerRestartSuppression <Boolean>] [-SoftwareInstallation <Boolean>]
 [-StateMessageVerbosity <VerbosityLevelType>] [-ThrottlingDays <Int32>] [-UseNeighborDP <Boolean>]
 [-UserNotificationOption <UserNotificationType>] [-UseSiteDefaultDP <Boolean>]
 [-WorkstationRestartSuppression <Boolean>] [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByCollectionName

New-CMSoftwareUpdatePhase [-AlertDelta <Int32>] [-AlertThresholdPercentage <Int32>] [-AlertUnit <TimeUnitType>]
 [-AllowMeteredConnection <Boolean>] [-AllowSystemRestart <Boolean>] [-AllowWumuFallback <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionName] <String> [-CriteriaOption <CriteriaType>]
 [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>]
 [-DeadlineValue <Int32>] [-DisableScomAlert <Boolean>] [-EnableAlert <Boolean>] [-EnableWakeOnLan <Boolean>]
 [-GenerateScomAlertOnFailure <Boolean>] [-InstallationChoice <InstallationChoiceType>]
 [-PhaseDescription <String>] -PhaseName <String> [-RequirePostRebootFullScan <Boolean>]
 [-ServerRestartSuppression <Boolean>] [-SoftwareInstallation <Boolean>]
 [-StateMessageVerbosity <VerbosityLevelType>] [-ThrottlingDays <Int32>] [-UseNeighborDP <Boolean>]
 [-UserNotificationOption <UserNotificationType>] [-UseSiteDefaultDP <Boolean>]
 [-WorkstationRestartSuppression <Boolean>] [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Sürüm 2002'den başlayarak, yazılım güncelleştirmesi için dağıtım aşaması oluşturmak üzere bu cmdlet'i kullanın.

EXAMPLES

Örnek 1: Yazılım güncelleştirme aşaması oluşturma

Bu örnek, yalnızca Yazılım Merkezi'nde görüntüecek MyCollection adlı koleksiyon için MySUPhase adlı bir yazılım güncelleştirme aşaması oluşturur.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

PARAMETERS

-AlertDelta

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Uyarılar sayfasındaki şu ayarla aynıdır: Son tarih zamanından uzaklığı. Uzaklık için bir tamsayı değeri belirtin ve ardından AlertUnit parametresiyle nokta türünü belirtin.

Bu değeri ayarlamak için EnableAlert parametresini kullan gerekir.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertThresholdPercentage

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Uyarılar sayfasındaki aşağıdaki ayarla aynıdır: İstemci uyumluluğu aşağıdaki (yüzde) altındadır. Yüzde için bir tamsayı değeri belirtin. Bu değeri ayarlamak için EnableAlert parametresini kullan gerekir.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertUnit

Nokta türünü belirtin. AlertDelta ile bu parametreyi kullanın.

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-AllowMeteredConnection

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın İndirme Ayarlar sayfasındaki şu ayarla aynıdır: Tarifeli bir internet bağlantısında istemcilerin, yükleme son tarihi sonrasında içerik indirmesine izin ver, bu ek ücrete neden olabilir.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSystemRestart

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Kullanıcı Deneyimi sayfasındaki şu ayarla aynıdır: Sistem yeniden başlatma (yüklemenin tamamlanması için gerekirse). Bu ayar, bu etkinliğin bakım penceresinin dışında gerçekleştirile izin vermek için yükleme son tarihine ulaşıldıklarına uygulanır.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowWumuFallback

Bu parametre, konsolundaki Aşama Ekleme Sihirbazı'nın İndirme Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Yazılım güncelleştirmeleri geçerli, komşu veya site sınır gruplarında dağıtım noktasında kullanılamıyorsa, Microsoft Güncelleştirmeleri'nden içerik indirin.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BeginCondition

Önceki aşama başarıyla başladıktan sonra dağıtımın bu aşamasına başlangıç için bir seçenek belirtin:

AfterPeriod: Bu parametre konsolda Aşama Ekleme Sihirbazı'nın Aşama Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Bu aşamayı erteleme süresi (gün olarak) sonra otomatik olarak başlatın. Bu değeri belirtirsanız, zaman dönemini yapılandırmak için DaysAfterPreviousPhaseSuccess kullanın.
Manually: Bu parametre konsolunda Aşama Ekleme Sihirbazı'nın Aşama Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Dağıtımın bu aşamasını el ile başlatın.

Type: BeginConditionType
Parameter Sets: (All)
Aliases:
Accepted values: AfterPeriod, Manually

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

-Collection

Hedef koleksiyon için bir nesne belirtin.

Type: IResultObject
Parameter Sets: SearchByCollection
Aliases:

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

-CollectionId

Kimliğine göre hedef koleksiyonu belirtin.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

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

-CollectionName

Hedef koleksiyonu adıyla belirtin.

Type: String
Parameter Sets: SearchByCollectionName
Aliases:

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

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

-CriteriaOption

Önceki aşamanın başarı ölçütlerini belirlemek için bir seçenek belirtin:

Compliance: Bu parametre konsolunda Aşama Ekleme Sihirbazı'nın Aşama Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Dağıtım başarı yüzdesi. CriteriaValue parametresiyle yüzde değerini belirtin.
Number: Bu parametre konsolda Aşama Ekleme Sihirbazı'nın Aşama Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Başarıyla dağıtılan cihaz sayısı. CriteriaValue parametresiyle cihaz sayısını belirtin.

Type: CriteriaType
Parameter Sets: (All)
Aliases:
Accepted values: Compliance, Number

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

-CriteriaValue

Bu tamsayı değeri, CriteriaOption için belirttiğiniz değere bağlıdır:

Compliance: Yüzdeyi belirtin
Number: Cihaz sayısını belirtin

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Bu aşamaya başlamak için önceki aşamanın başarılı olduğu gün sayısı için bir tamsayı değeri belirtin. Bu parametre konsolda Aşama Ekleme Sihirbazı'nın Aşama Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Bu aşamayı erteleme süresi (gün olarak) sonra otomatik olarak başlatın.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Son tarih döneminin türünü belirtin. DeadlineValue ile bu parametreyi kullanın.

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-DeadlineValue

Bu parametre yalnızca AfterPeriod InstallationChoice parametresiyle belirttiğinizde kullanılır.

Son tarih için zaman aralığı için bir tamsayı değeri belirtin. Dönem türünü belirtmek için DeadlineUnit parametresini kullanın: Hours , , , Days Weeks Months . Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Ayarlar Aşaması Sihirbazı sayfasındaki aşağıdaki ayarla aynıdır: Bu sürenin ardından yükleme gereklidir.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DisableScomAlert

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Uyarılar sayfasındaki şu ayarla aynıdır: Yazılım güncelleştirmeleri çalışırken Operations Manager uyarıları devre dışı bırakma.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Bu parametre joker karakterleri değişmez karakter değerleri olarak kabul eder. ForceWildcardHandling ile birleştiresiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAlert

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Uyarılar sayfasındaki aşağıdaki ayarla aynıdır: Aşağıdaki koşullar karşı kullanıldığında bir uyarı oluşturma. Bu parametreyi olarak ayar $true her zaman aşağıdaki parametreleri de ayarlayın:

AlertThresholdPercentage
AlertDelta

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableWakeOnLan

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Dağıtım Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Gerekli dağıtımlar için istemcileri uyandırmak için LAN'da Uyandırma kullanın.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Bu parametre joker karakterleri işler ve beklenmeyen davranışlara yol açabilirsiniz. Bu önerilmez. DisableWildcardHandling ile birleştiresiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateScomAlertOnFailure

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Uyarılar sayfasındaki şu ayarla aynıdır: Bir yazılım güncelleştirmesi yüklemesi başarısız olduğunda Operations Manager uyarısı oluşturma.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Yazılımın ne zaman kullanılabilir olduğuyla ilgili davranış için bir seçenek belirtin:

AsSoonAsPossible: Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Ayarlar Aşaması Sihirbazı sayfasındaki aşağıdaki ayarla aynıdır: Yükleme en kısa sürede gereklidir.
AfterPeriod: Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Aşama Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Bu sürenin ardından yükleme gereklidir. Bu değeri belirtirsiniz, zaman dönemini yapılandırmak için DeadlineUnit ve DeadlineValue değerlerini kullanın.

Type: InstallationChoiceType
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, AfterPeriod

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

-PhaseDescription

Aşama için bir açıklama belirtin.

Type: String
Parameter Sets: (All)
Aliases:

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

-PhaseName

Açıklama için bir ad belirtin.

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

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

-RequirePostRebootFullScan

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Kullanıcı Deneyimi sayfasındaki aşağıdaki ayarla aynıdır: Bu dağıtımda yapılan herhangi bir güncelleştirme sistemin yeniden başlatılmasını gerektiriyorsa, güncelleştirme dağıtım değerlendirme döngüsünü yeniden başlattıktan sonra çalıştırın.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ServerRestartSuppression

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Kullanıcı Deneyimi sayfasındaki aşağıdaki ayarla aynıdır. Sistem yeniden başlatmasını şu cihazlarda gizleme: Sunucular.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Kullanıcı Deneyimi sayfasındaki aşağıdaki ayarla aynıdır: Yazılım Yüklemesi. Bu ayar, bu etkinliğin bakım penceresinin dışında gerçekleştirile izin vermek için yükleme son tarihine ulaşıldıklarına uygulanır.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-StateMessageVerbosity

Bu parametre, konsolunda Aşama Ekleme Sihirbazı'nın Dağıtım Ayarlar sayfasındaki aşağıdaki ayarla aynıdır: Durum iletisi ayrıntı düzeyi aşağıdaki değerlerle:

AllMessages: Tüm iletiler
OnlySuccessAndErrorMessages: Yalnızca başarı ve hata iletileri
OnlyErrorMessages: Yalnızca hata iletileri

Type: VerbosityLevelType
Parameter Sets: (All)
Aliases:
Accepted values: AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages

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

-Kısıtlar Lingdays

Bu yazılımın aşamalı olarak kullanılabilmesi için gün sayısı olarak bir tamsayı değeri belirtin. bu parametre, konsolundaki aşama Ayarlar sayfasında aşağıdaki ayarla aynıdır: kademeli olarak bu yazılımın bu süre içinde kullanılabilmesini sağlama (gün cinsinden).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Usensekizinci Bordp

bu parametre, konsolundaki aşama ekleme sihirbazı ' nın indir Ayarlar sayfasında aşağıdaki ayarla aynıdır: bir istemci, bir komşu sınır grubundan veya varsayılan site sınır grubundan bir dağıtım noktası kullandığında kullanılacak dağıtım seçeneğini seçin. Aşağıdaki değerleri belirtin:

$true: Yazılım güncelleştirmelerini dağıtım noktasından indir ve yükle
$false: Yazılım güncelleştirmelerini yüklemeyin

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSiteDefaultDP

bu parametre, konsolundaki aşama ekleme sihirbazının Ayarlar yükle sayfasında bulunan aşağıdaki ayarla aynıdır: yazılım güncelleştirmeleri geçerli veya komşu sınır grubundaki herhangi bir dağıtım noktasında kullanılabilir olmadığında, istemci, yazılım güncelleştirmelerini site varsayılan sınır grubundaki dağıtım noktalarından indirebilir ve yükleyebilir. Aşağıdaki değerleri belirtin:

$true: Yazılım güncelleştirmelerini site varsayılan sınır grubundaki dağıtım noktalarından indir ve yükle
$false: Yazılım güncelleştirmelerini yüklemeyin

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotificationOption

Bu parametre, konsolundaki aşama Ekleme sihirbazının Kullanıcı deneyimi sayfasında bulunan aşağıdaki ayarla aynıdır: Bu dağıtım için Kullanıcı deneyimi ayarını aşağıdaki değerlerle belirtin:

DisplayAll: Yazılım Merkezi 'nde görüntüle ve tüm bildirimleri göster
DisplaySoftwareCenterOnly: Yazılım Merkezi 'nde görüntüle ve yalnızca bilgisayar yeniden başlatmaları için bildirimleri göster
HideAll: Yazılım Merkezi 'nde ve tüm bildirimlerde gizle

Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll

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ıştırılmaz.

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

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

-WorkstationRestartSuppression

Bu parametre, konsolundaki aşama Ekleme sihirbazının Kullanıcı deneyimi sayfasında aşağıdaki ayarla aynıdır. Aşağıdaki cihazlarda sistem yeniden başlatmasını gizleyin: Iş istasyonları.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Writefiltercommıt

Bu parametre, konsolundaki aşama Ekleme sihirbazının Kullanıcı deneyimi sayfasında aşağıdaki ayarla aynıdır: değişiklikleri son tarihte veya bakım penceresinde Yürüt (yeniden başlatma gerektirir). bu ayar, katıştırılmış Windows cihazları için yazma filtresi işleme için geçerlidir.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
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.