Udostępnij za pośrednictwem

Set-CMAutoDeploymentRuleDeployment

  • Artykuł

SYNOPSIS

Ustawia wdrożenie reguły wdrażania automatycznego.

SYNTAX

ByValue (wartość domyślna)

Set-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
 [-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
 [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 [-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
 [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
 [-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-InputObject] <IResultObject>
 [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-PassThru]
 [-RequirePostRebootFullScan <Boolean>] [-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>]
 [-SuccessPercentage <Int32>] [-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>]
 [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>]
 [-VerboseLevel <VerboseLevelType>] [-WriteFilterHandling <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ById

Set-CMAutoDeploymentRuleDeployment [-AlertTime <Int32>] [-AlertTimeUnit <TimeUnitType>]
 [-AllowDownloadFromMicrosoftUpdate <Boolean>] [-AllowRestart <Boolean>]
 [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 [-AvailableImmediately <Boolean>] [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>]
 [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>] [-DeadlineTimeUnit <TimeUnitType>]
 [-DisableOperationsManager <Boolean>] [-EnableDeployment <Boolean>]
 [-GenerateOperationsManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>] [-Id] <Int32>
 [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-PassThru]
 [-RequirePostRebootFullScan <Boolean>] [-SendWakeupPacket <Boolean>] [-SoftDeadlineEnabled <Boolean>]
 [-SuccessPercentage <Int32>] [-SuppressRestartServer <Boolean>] [-SuppressRestartWorkstation <Boolean>]
 [-UseBranchCache <Boolean>] [-UserNotification <UserNotificationOption>] [-UseUtc <Boolean>]
 [-VerboseLevel <VerboseLevelType>] [-WriteFilterHandling <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Polecenie cmdlet Set-CMAutoDeploymentRuleDeployment aktualizuje wdrożenie reguły wdrażania automatycznego.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: ustawianie wdrożenia według identyfikatora

PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False  -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer  $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False

To polecenie aktualizuje ustawienia wdrożenia reguły wdrażania przy użyciu identyfikatora akcji 348 i kolekcji o nazwie Wszystkie systemy.

Przykład 2: ustawianie wdrożenia przy użyciu zmiennej

PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $False

Pierwsze polecenie pobiera obiekt reguły wdrażania automatycznego o nazwie TestADR01 i zapisuje obiekt w $ReferenceADR zmiennej.

Drugie polecenie pobiera wdrożenia skojarzone z obiektem reguły wdrażania automatycznego przechowywanego w programie $ReferenceADR i przechowuje wdrożenia w zmiennej $Deployment wdrożenia.

Ostatnie polecenie aktualizuje ustawienia pierwszego wdrożenia przechowywanego w programie $Deployment.

PARAMETERS

-AlertTime

Określa liczbę jednostek czasu przesunięcia od terminu ostatecznego.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertTimeUnit

Określa typ jednostki czasu dla przesunięcia od terminu ostatecznego. Prawidłowe wartości:

  • Godziny
  • Dni
  • Tygodnie
  • Miesiące
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

-AllowDownloadFromMicrosoftUpdate

Począwszy od wersji 1906, użyj tego parametru, aby ustawić następującą opcję na stronie Pobierz Ustawienia ustawień wdrażania adr: jeśli aktualizacje oprogramowania nie są dostępne w punkcie dystrybucji w grupach bieżących, sąsiednich lub granic lokacji, pobierz zawartość z usługi Microsoft Updates.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRestart

Wskazuje, czy po osiągnięciu ostatecznego terminu instalacji można wykonać ponowne uruchomienie systemu poza zdefiniowanymi oknami obsługi.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

Wskazuje, czy po osiągnięciu ostatecznego terminu instalacji można przeprowadzić instalację oprogramowania poza zdefiniowanymi oknami obsługi.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowUseMeteredNetwork

Począwszy od wersji 1906, użyj tego parametru, aby ustawić następującą opcję na stronie Pobieranie Ustawienia ustawień wdrażania adr: Zezwalaj klientom mierzonego połączenia internetowego na pobieranie zawartości po upływie ostatecznego terminu instalacji, co może spowodować dodatkowe koszty

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AvailableImmediately

Wskazuje, czy aktualizacje oprogramowania są dostępne do zainstalowania tak szybko, jak to możliwe po uruchomieniu reguły.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AvailableTime

Określa liczbę jednostek czasu dla dostępnego czasu oprogramowania.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AvailableTimeUnit

Określa typ jednostki czasu dla czasu dostępnego oprogramowania. Prawidłowe wartości:

  • Godziny
  • Dni
  • Tygodnie
  • Miesiące
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

-Kolekcji

Określa obiekt kolekcji docelowej dla wdrożenia aktualizacji oprogramowania. Aby uzyskać obiekt kolekcji, użyj polecenia cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Określa identyfikator kolekcji docelowej wdrożenia aktualizacji oprogramowania.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName (Nazwa kolekcji)

Określa nazwę kolekcji docelowej wdrożenia aktualizacji oprogramowania.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DeadlineImmediately

Wskazuje, czy wymagane aktualizacje oprogramowania są instalowane tak szybko, jak to możliwe po osiągnięciu ostatecznego terminu.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DeadlineTime

Określa liczbę jednostek czasu dla terminu ostatecznego.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineTimeUnit

Określa typ jednostki czasu dla terminu ostatecznego. Prawidłowe wartości:

  • Godziny
  • Dni
  • Tygodnie
  • Miesiące
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

-DisableOperationsManager

Wskazuje, czy Operations Manager są wyłączone podczas uruchamiania aktualizacji oprogramowania.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableDeployment

Wskazuje, czy włączyć wdrożenie po tym, jak ta reguła zostanie uruchomiona dla skojarzonej grupy oprogramowania. W przypadku ustawienia $False należy ręcznie wdrożyć grupę aktualizacji oprogramowania.

Type: Boolean
Parameter Sets: (All)
Aliases: Enable, EnabledAfterCreate, EnableAfterCreate

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateOperationsManagerAlert

Wskazuje, Operations Manager są generowane alerty w przypadku niepowodzenia instalacji aktualizacji oprogramowania.

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

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

-GenerateSuccessAlert

Wskazuje, czy alert jest generowany, gdy ta reguła zostanie pomyślnie uruchomiona.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Id (Identyfikator)

Określa identyfikator akcji wdrażania reguły wdrażania automatycznego.

Type: Int32
Parameter Sets: ById
Aliases: ActionID

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

-InputObject

Określa obiekt reguły wdrażania automatycznego. Aby uzyskać obiekt reguły wdrażania automatycznego, użyj polecenia cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.

Type: IResultObject
Parameter Sets: ByValue
Aliases: AutoDeploymentRuleDeployment

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

-NoInstallOnRemote

Wskazuje, czy zainstalować aktualizacje oprogramowania, gdy aktualizacje nie są dostępne w żadnym zdalnym punkcie dystrybucji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-NoInstallOnUnprotected

Wskazuje, czy aktualizacje oprogramowania mają być zainstalowane, gdy nie są dostępne w żadnym niechronionym punkcie dystrybucji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PassThru

Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RequirePostRebootFullScan

Począwszy od wersji 1906, użyj tego parametru, aby ustawić następującą opcję na stronie Środowisko użytkownika ustawień wdrażania adr: Jeśli jakakolwiek aktualizacja w tym wdrożeniu wymaga ponownego uruchomienia systemu, uruchom cykl oceny wdrożenia aktualizacji po ponownym uruchomieniu.

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

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

-SendWakeupPacket

Wskazuje, czy używać funkcji Wake-on-LAN do wznawiania klientów dla wymaganych wdrożeń.

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

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

-SoftDeadlineEnabled

Począwszy od wersji 1906 użyj tego parametru, aby ustawić następującą opcję na stronie Harmonogram wdrażania ustawień wdrażania adr: Opóźnij wymuszanie tego wdrożenia zgodnie z preferencjami użytkownika, do okresu prolongaty zdefiniowanego w ustawieniach klienta .

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

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

-SuccessPercentage

Określa procent zgodności klienta jako liczbę całkowitą. Gdy wartość procentowa zgodności klienta spadnie poniżej tej wartości procentowej, generowany jest alert.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-SuppressRestartServer

Wskazuje, czy ponowne uruchomienie systemu jest pomijane na serwerach, gdy aktualizacja oprogramowania wymaga ponownego uruchomienia systemu w celu ukończenia procesu instalacji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SuppressRestartWorkstation

Wskazuje, czy ponowne uruchomienie systemu jest pomijane na stacjach roboczych, gdy aktualizacja oprogramowania wymaga ponownego uruchomienia systemu w celu ukończenia procesu instalacji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseBranchCache

Wskazuje, czy klienci mogą udostępniać zawartość innym klientom w tej samej podsieci.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseUtc

Wskazuje, czy harmonogram tego wdrożenia jest oceniany na podstawie uniwersalnego czasu koordynowanej (UTC).

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotification

Określa zachowanie powiadomień w interfejsie wizualnym użytkownika. Prawidłowe wartości:

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

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

-VerboseLevel

Określa, ile szczegółów stanu klienci raportuje z powrotem dla wdrożeń utworzonych przez tę regułę. Prawidłowe wartości:

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

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

-WriteFilterHandling

Wskazuje, czy zmiany są zatwierdzone w terminie ostatecznym, czy w oknie obsługi (wymaga ponownego uruchomienia). Jeśli ustawisz $False, zawartość zostanie zastosowana do nakładki i zatwierdzona później.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_AdrDeploymentSettings

UWAGI

Get-CMCollection

Get-CMAutoDeploymentRuleDeployment

Get-CMSoftwareUpdateAutoDeploymentRule

New-CMAutoDeploymentRuleDeployment

Remove-CMAutoDeploymentRuleDeployment