Share via

Set-CMTaskSequenceDeploymentType

  • Artykuł

SYNOPSIS

Skonfiguruj typ wdrożenia sekwencji zadań w aplikacji.

SYNTAX

ByAppName (ustawienie domyślne)

Set-CMTaskSequenceDeploymentType [-AddDetectionClause <DetectionClause[]>]
 [-DetectionClauseConnector <Hashtable[]>] [-EstimatedRuntimeMins <Int32>]
 [-ForceScriptDetection32Bit <Boolean>] [-GroupDetectionClauses <String[]>]
 [-InstallationBehaviorType <InstallationBehaviorType>] -InstallTaskSequenceId <String>
 [-LogonRequirementType <LogonRequirementType>] [-MaximumRuntimeMins <Int32>] [-ProductCode <String>]
 [-RebootBehavior <PostExecutionBehavior>] [-RemoveDetectionClause <String[]>]
 [-RequireUserInteraction <Boolean>] [-ScriptFile <String>] [-ScriptLanguage <ScriptLanguage>]
 [-ScriptText <String>] [-SlowNetworkDeploymentMode <ContentHandlingMode>] [-UninstallTaskSequenceId <String>]
 [-UserInteractionMode <UserInteractionMode>] [-AddRequirement <Rule[]>] -ApplicationName <String>
 -DeploymentTypeName <String> [-NewName <String>] [-PassThru] [-RemoveLanguage <String[]>]
 [-RemoveRequirement <Rule[]>] [-AddLanguage <String[]>] [-Comment <String>] [-Force]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ByAppValue

Set-CMTaskSequenceDeploymentType [-AddDetectionClause <DetectionClause[]>]
 [-DetectionClauseConnector <Hashtable[]>] [-EstimatedRuntimeMins <Int32>]
 [-ForceScriptDetection32Bit <Boolean>] [-GroupDetectionClauses <String[]>]
 [-InstallationBehaviorType <InstallationBehaviorType>] -InstallTaskSequenceId <String>
 [-LogonRequirementType <LogonRequirementType>] [-MaximumRuntimeMins <Int32>] [-ProductCode <String>]
 [-RebootBehavior <PostExecutionBehavior>] [-RemoveDetectionClause <String[]>]
 [-RequireUserInteraction <Boolean>] [-ScriptFile <String>] [-ScriptLanguage <ScriptLanguage>]
 [-ScriptText <String>] [-SlowNetworkDeploymentMode <ContentHandlingMode>] [-UninstallTaskSequenceId <String>]
 [-UserInteractionMode <UserInteractionMode>] [-AddRequirement <Rule[]>] -Application <IResultObject>
 -DeploymentTypeName <String> [-NewName <String>] [-PassThru] [-RemoveLanguage <String[]>]
 [-RemoveRequirement <Rule[]>] [-AddLanguage <String[]>] [-Comment <String>] [-Force]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ByAppId

Set-CMTaskSequenceDeploymentType [-AddDetectionClause <DetectionClause[]>]
 [-DetectionClauseConnector <Hashtable[]>] [-EstimatedRuntimeMins <Int32>]
 [-ForceScriptDetection32Bit <Boolean>] [-GroupDetectionClauses <String[]>]
 [-InstallationBehaviorType <InstallationBehaviorType>] -InstallTaskSequenceId <String>
 [-LogonRequirementType <LogonRequirementType>] [-MaximumRuntimeMins <Int32>] [-ProductCode <String>]
 [-RebootBehavior <PostExecutionBehavior>] [-RemoveDetectionClause <String[]>]
 [-RequireUserInteraction <Boolean>] [-ScriptFile <String>] [-ScriptLanguage <ScriptLanguage>]
 [-ScriptText <String>] [-SlowNetworkDeploymentMode <ContentHandlingMode>] [-UninstallTaskSequenceId <String>]
 [-UserInteractionMode <UserInteractionMode>] [-AddRequirement <Rule[]>] -ApplicationId <Int32>
 -DeploymentTypeName <String> [-NewName <String>] [-PassThru] [-RemoveLanguage <String[]>]
 [-RemoveRequirement <Rule[]>] [-AddLanguage <String[]>] [-Comment <String>] [-Force]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ByDTValue

Set-CMTaskSequenceDeploymentType [-AddDetectionClause <DetectionClause[]>]
 [-DetectionClauseConnector <Hashtable[]>] [-EstimatedRuntimeMins <Int32>]
 [-ForceScriptDetection32Bit <Boolean>] [-GroupDetectionClauses <String[]>]
 [-InstallationBehaviorType <InstallationBehaviorType>] -InstallTaskSequenceId <String>
 [-LogonRequirementType <LogonRequirementType>] [-MaximumRuntimeMins <Int32>] [-ProductCode <String>]
 [-RebootBehavior <PostExecutionBehavior>] [-RemoveDetectionClause <String[]>]
 [-RequireUserInteraction <Boolean>] [-ScriptFile <String>] [-ScriptLanguage <ScriptLanguage>]
 [-ScriptText <String>] [-SlowNetworkDeploymentMode <ContentHandlingMode>] [-UninstallTaskSequenceId <String>]
 [-UserInteractionMode <UserInteractionMode>] [-AddRequirement <Rule[]>] -InputObject <IResultObject>
 [-NewName <String>] [-PassThru] [-RemoveLanguage <String[]>] [-RemoveRequirement <Rule[]>]
 [-AddLanguage <String[]>] [-Comment <String>] [-Force] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Dotyczy wersji 2006 i nowszych. To polecenie cmdlet umożliwia skonfigurowanie typu wdrożenia sekwencji zadań w aplikacji. Aby uzyskać więcej informacji, zobacz Typ wdrożenia sekwencji zadań.

To polecenie cmdlet ma podobną składnię jak typ wdrożenia MSI polecenie cmdlet Set-CMMsiDeploymentType. Podstawowe różnice są następujące:

  • -InstallTaskSequenceId <string> (wymagane): identyfikator sekwencji zadań do zainstalowania aplikacji

  • -UninstallTaskSequenceId <string> (opcjonalnie): identyfikator sekwencji zadań do odinstalowania aplikacji

Te dwa parametry odnoszą się do opcji sekwencji zadań typu wdrożenia. Zastępują parametry -InstallCommand i -UninstallCommand w poleceniach cmdlet MSI.

EXAMPLES

Przykład 1. Modyfikowanie typu wdrożenia sekwencji zadań

To polecenie zmienia nazwę typu wdrożenia z Instalacja złożona na Instalacja zaawansowana. Dodaje język angielski (Stany Zjednoczone) ( en-US ) i chiński (uproszczony) ( zh-CN ) jako obsługiwane języki. Określa, że instalacja potrwa około 14 minut i będzie uruchamiana tylko wtedy, gdy żaden użytkownik nie jest zalogowany do Windows.

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

Aby uzyskać inne przykłady z regułami wymagań i metodami wykrywania, zobacz Set-CMScriptDeploymentType i Add-CMMsiDeploymentType.

PARAMETERS

-AddDetectionClause

Określ tablicę klauzul metody wykrywania dla tego typu wdrożenia. Aby utworzyć klauzulę wykrywania, użyj jednego z następujących cmdlet:

Zapisz dane wyjściowe tych cmdlet w zmiennej. Następnie określ te zmienne jako tablicę dla tego parametru. Na przykład -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Możesz również użyć polecenia Get-CMDeploymentTypeDetectionClause, aby pobrać istniejącą klauzulę wykrywania z innej aplikacji.

Type: DetectionClause[]
Parameter Sets: (All)
Aliases: AddDetectionClauses

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

-AddLanguage

Określ tablicę tagów języka, które obsługuje typ wdrożenia. Aby na przykład dodać język rosyjski (Rosyjski), określ tag ru-RU .

Aby uzyskać więcej informacji i listę tagów języka, zobacz Windows Language Code Identifier (LCID) Reference (Informacjeo identyfikatorze kodu języka (LCID) ).

Type: String[]
Parameter Sets: (All)
Aliases: AddLanguages, Languages, Language

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

-AddRequirement

Określ tablicę obiektów wymagań dla typu wdrożenia. Aby utworzyć obiekt reguły wymagania, użyj jednego z następujących cmdlet:

Type: Rule[]
Parameter Sets: (All)
Aliases:

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

-Aplikacji

Określ obiekt aplikacji dla tego typu wdrożenia. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMApplication.

Type: IResultObject
Parameter Sets: ByAppValue
Aliases:

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

-ApplicationId

Określ identyfikator aplikacji dla tego typu wdrożenia.

Type: Int32
Parameter Sets: ByAppId
Aliases: CI_ID, CIId

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

-ApplicationName

Określ nazwę aplikacji dla tego typu wdrożenia.

Type: String
Parameter Sets: ByAppName
Aliases:

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

-Komentarz

Podaj opcjonalny opis typu wdrożenia.

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

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: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentTypeName

Określ nazwę typu wdrożenia do skonfigurowania.

Type: String
Parameter Sets: ByAppName, ByAppValue, ByAppId
Aliases:

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

-DetectionClauseConnector

W przypadku użycia parametru GroupDetectionClauses do grupowania klauzul wykrywania użyj tego parametru, aby określić łącznik.

W poniższym przykładzie zdefiniowano łącznik OR:@{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Type: Hashtable[]
Parameter Sets: (All)
Aliases: DetectionClauseConnectors

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

-EstimatedRuntimeMins

Określ szacowany czas instalacji tego typu wdrożenia dla aplikacji (w minutach). Centrum oprogramowania wyświetla to oszacowanie użytkownikowi przed zainstalowaniem aplikacji.

Type: Int32
Parameter Sets: (All)
Aliases: EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes

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

-Force

Wymusza uruchomienie polecenia bez pytania o potwierdzenie przez użytkownika.

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

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

-ForceScriptDetection32Bit

Jeśli używasz niestandardowego skryptu do wykrywania obecności tego typu wdrożenia, ustaw ten parametr na , aby uruchomić skrypt jako $true proces 32-bitowy na klientach 64-bitowych.

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

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

-GroupDetectionClauses

Podczas konfigurowania reguł w celu wykrywania obecności tego typu wdrożenia użyj tego parametru do grupowania klauzul. Aby utworzyć klauzulę wykrywania, użyj jednego z następujących cmdlet:

Zapisz dane wyjściowe tych cmdlet w zmiennej. Następnie użyj następującego formatu, aby zgrupować klauzule: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Porada

W Menedżer konfiguracji konsoli programu po wybraniu akcji Grupuj klauzule pokazują nawiasy przed i po zgrupowanych klauzulach.

Type: String[]
Parameter Sets: (All)
Aliases: GroupDetectionClausesByLogicalName

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

-InputObject

Określ obiekt typu wdrożenia do skonfigurowania. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMDeploymentType.

Type: IResultObject
Parameter Sets: ByDTValue
Aliases: DeploymentType

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

-InstallTaskSequenceId

Identyfikator sekwencji zadań instalacji aplikacji.

Type: String
Parameter Sets: (All)
Aliases:

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

-InstallationBehaviorType

Określ zachowanie instalacji dla tego typu wdrożenia:

  • InstallForUser: klient instaluje aplikację tylko dla użytkownika, u którego aplikacja jest wdrażana.
  • InstallForSystem: klient instaluje aplikację tylko raz. Jest ona dostępna dla wszystkich użytkowników.
  • InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: w przypadku wdrożenia aplikacji na urządzeniu klient zainstaluje ją dla wszystkich użytkowników. Jeśli aplikacja zostanie wdrożona dla użytkownika, klient zainstaluje ją tylko dla tego użytkownika.
Type: InstallationBehaviorType
Parameter Sets: (All)
Aliases:
Accepted values: InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser

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

-LogonRequirementType

Określ wymaganie dla zalogowaowego użytkownika:

  • OnlyWhenNoUserLoggedOn: tylko wtedy, gdy żaden użytkownik nie jest zalogowany do Windows.

  • OnlyWhenUserLoggedOn: tylko wtedy, gdy użytkownik jest zalogowany. Ta opcja jest domyślnie zaznaczona.

  • WhetherOrNotUserLoggedOn: czy użytkownik jest zalogowany.

    Uwaga

    Wartość WhereOrNotUserLoggedOn jest przestarzała. Jest on zastępowany przez WhetherOrNotUserLoggedOn .

W przypadku ustawienia parametru InstallationBehaviorType na InstallForUser wartość nie można ustawić tego parametru.

Type: LogonRequirementType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn

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

-MaximumRuntimeMins

Określ maksymalny dozwolony czas uruchamiania programu wdrażania dla tej aplikacji. Ustaw wartość całkowitą w minutach.

Type: Int32
Parameter Sets: (All)
Aliases: MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes

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

-NewName

Określ nową nazwę, aby zmienić nazwę tego typu wdrożenia.

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

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

-ProductCode (Kod produktu)

Jeśli aplikacja używa Windows instalatora, określ kod produktu MSI, który ma być ustawiany jako metoda wykrywania. Użycie tego parametru spowoduje zastąpienie wszystkich istniejących metod wykrywania.

Type: String
Parameter Sets: (All)
Aliases:

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

-RebootBehavior

Określ zachowanie po instalacji:

  • BasedOnExitCode: określ zachowanie na podstawie kodów powrotnych.

  • NoAction: Brak określonej akcji.

  • ProgramReboot: Program instalacji oprogramowania może wymusić ponowne uruchomienie urządzenia.

  • ForceReboot: Menedżer konfiguracji wymusi obowiązkowe ponowne uruchomienie urządzenia.

Aby uzyskać więcej informacji na temat tych zachowań, zobacz Tworzenie aplikacji w programie Menedżer konfiguracji.

Type: PostExecutionBehavior
Parameter Sets: (All)
Aliases:
Accepted values: BasedOnExitCode, NoAction, ForceReboot, ProgramReboot

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

-RemoveDetectionClause

Określ tablicę klauzul metody wykrywania do usunięcia.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveDetectionClauses

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

-RemoveLanguage

Określ tablicę obsługiwanych języków do usunięcia z tego typu wdrożenia.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveLanguages

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

-RemoveRequirement

Określ tablicę reguł wymagań do usunięcia z tego typu wdrożenia.

Type: Rule[]
Parameter Sets: (All)
Aliases: RemoveRequirements

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

-RequireUserInteraction

Ustaw ten parametr na , aby umożliwić użytkownikom wyświetlanie instalacji typu wdrożenia i interakcję $true z tą instalacją.

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

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

-ScriptFile

Określ plik skryptu do użycia w celu wykrycia tego typu wdrożenia. Użyj również parametru ScriptLanguage.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScriptLanguage

Jeśli używasz parametrów ScriptFile lub ScriptText, użyj tego parametru, aby określić język skryptów.

Type: ScriptLanguage
Parameter Sets: (All)
Aliases: ScriptType
Accepted values: PowerShell, VBScript, JavaScript

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

-ScriptText

Określ tekst skryptu do wykrywania tego typu wdrożenia. Użyj również parametru ScriptLanguage.

Aby uzyskać więcej informacji, zobacz About custom script detection methods (Informacje o metodach wykrywania niestandardowych skryptów).

Type: String
Parameter Sets: (All)
Aliases: ScriptContent, Script

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

-SlowNetworkDeploymentMode

Jeśli klient używa punktu dystrybucji z grupy granic sąsiada lub domyślnej grupy granic lokacji, określ opcję wdrożenia:

  • DoNothing: nie pobieraj zawartości
  • Download: pobieranie zawartości z punktu dystrybucji i uruchamianie lokalnie
Type: ContentHandlingMode
Parameter Sets: (All)
Aliases:
Accepted values: DoNothing, Download

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

-UninstallTaskSequenceId

Identyfikator sekwencji zadań do odinstalowania aplikacji.

Type: String
Parameter Sets: (All)
Aliases: ContentLocation, UninstallId

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

-UserInteractionMode

Określ widoczność programu instalacyjnego:

  • Normal: Typ wdrożenia jest uruchamiany w trybie normalnym na podstawie ustawień domyślnych systemu i programu. Ten tryb jest domyślny.
  • Minimized: Typ wdrożenia jest uruchamiany na urządzeniach klienckich w sposób zminimalizowany. Użytkownicy mogą zobaczyć działanie instalacji w obszarze powiadomień lub na pasku zadań.
  • Maximized: typ wdrożenia jest uruchamiany zmaksymalizowany na urządzeniach klienckich. Użytkownicy widzą wszystkie działania instalacyjne.
  • Hidden: Typ wdrożenia jest ukryty na urządzeniach klienckich. Użytkownicy nie widzą żadnych działań instalacyjnych.
Type: UserInteractionMode
Parameter Sets: (All)
Aliases: InstallationProgramVisibility
Accepted values: Normal, Minimized, Maximized, Hidden

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

System.Object

UWAGI

Add-CMTaskSequenceDeploymentType

Get-CMDeploymentType

Remove-CMDeploymentType

Get-CMApplication

Typ wdrożenia sekwencji zadań