New-CMAutoDeploymentRuleDeployment

SYNOPSIS

Utwórz wdrożenie dla reguły wdrażania automatycznego.

SYNTAX

ByName (wartość domyślna)

New-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>] [-Name] <String>
 [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>] [-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

New-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>] [-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>]

ByValue

New-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>] [-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 New-CMAutoDeploymentRuleDeployment tworzy wdrożenie reguły wdrażania automatycznego (ADR).

EXAMPLES

Przykład 1: tworzenie wdrożenia dla reguły wdrażania automatycznego według nazwy

To polecenie tworzy wdrożenie reguły wdrażania automatycznego TestDepRule01 i kolekcji Wszystkie systemy.

New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -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

Przykład 2: tworzenie wdrożenia dla reguły wdrażania automatycznego według obiektu

To polecenie pobiera obiekt reguły wdrażania automatycznego o nazwie TestDepRule02. Następnie używa operatora potoku, aby przekazać obiekt do polecenia New-CMAutoDeploymentRuleDeployment, co powoduje utworzenie wdrożenia reguły wdrażania automatycznego TestDepRule02 i kolekcji Wszystkie systemy.

Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -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

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.

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 Pobieranie 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 instalacja oprogramowania może być wykonywana poza zdefiniowanymi oknami obsługi po osiągnięciu ostatecznego terminu instalacji.

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ć naliczanie dodatkowych kosztów

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 czasu dostępnego 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.

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

-Collection (Kolekcja)

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 dla 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

Określa nazwę kolekcji docelowej dla 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.

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 znaków literału. 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 $False ustawienia na wartość 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, czy Operations Manager są generowane 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 reguły wdrażania automatycznego, aby dodać to wdrożenie.

Type: Int32
Parameter Sets: ById
Aliases: AutoDeploymentID

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 dodać to wdrożenie. Aby uzyskać obiekt reguły wdrażania automatycznego, użyj polecenia cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.

Type: IResultObject
Parameter Sets: ByValue
Aliases: AutoDeploymentRule

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

-Name

Określa nazwę reguły wdrażania automatycznego, aby dodać to wdrożenie.

Type: String
Parameter Sets: ByName
Aliases: AutoDeploymentName

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

-NoInstallOnRemote

Wskazuje, czy aktualizacje oprogramowania mają być zainstalowane, 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 aktualizacje nie są dostępne w niechronionych punktach dystrybucji.

Type: Boolean
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 wartość procentową jako liczbę całkowitą zgodności klienta. Gdy wartość 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 wizualizacji użytkownika.

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łę.

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 wartość , 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

RELATED LINKS

Get-CMAutoDeploymentRuleDeployment

Remove-CMAutoDeploymentRuleDeployment

Set-CMAutoDeploymentRuleDeployment