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).
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
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