Set-CMScriptDeploymentType
Configurar um tipo de implementação do instalador de scripts.
Sintaxe
Set-CMScriptDeploymentType
[-ContentLocation <String>]
[-AddDetectionClause <DetectionClause[]>]
[-CacheContent <Boolean>]
[-ContentFallback <Boolean>]
[-DetectionClauseConnector <Hashtable[]>]
[-EnableBranchCache <Boolean>]
[-EstimatedRuntimeMins <Int32>]
[-Force32Bit <Boolean>]
[-ForceScriptDetection32Bit <Boolean>]
[-GroupDetectionClauses <String[]>]
[-InstallationBehaviorType <InstallationBehaviorType>]
[-InstallCommand <String>]
[-InstallWorkingDirectory <String>]
[-LogonRequirementType <LogonRequirementType>]
[-MaximumRuntimeMins <Int32>]
[-ProductCode <String>]
[-RebootBehavior <PostExecutionBehavior>]
[-RemoveDetectionClause <String[]>]
[-RepairCommand <String>]
[-RepairWorkingDirectory <String>]
[-RequireUserInteraction <Boolean>]
[-ScriptFile <String>]
[-ScriptLanguage <ScriptLanguage>]
[-ScriptText <String>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-SourceUpdateProductCode <String>]
[-UninstallCommand <String>]
[-UninstallContentLocation <String>]
[-UninstallOption <UninstallContentSetting>]
[-UninstallWorkingDirectory <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>]
Set-CMScriptDeploymentType
[-ContentLocation <String>]
[-AddDetectionClause <DetectionClause[]>]
[-CacheContent <Boolean>]
[-ContentFallback <Boolean>]
[-DetectionClauseConnector <Hashtable[]>]
[-EnableBranchCache <Boolean>]
[-EstimatedRuntimeMins <Int32>]
[-Force32Bit <Boolean>]
[-ForceScriptDetection32Bit <Boolean>]
[-GroupDetectionClauses <String[]>]
[-InstallationBehaviorType <InstallationBehaviorType>]
[-InstallCommand <String>]
[-InstallWorkingDirectory <String>]
[-LogonRequirementType <LogonRequirementType>]
[-MaximumRuntimeMins <Int32>]
[-ProductCode <String>]
[-RebootBehavior <PostExecutionBehavior>]
[-RemoveDetectionClause <String[]>]
[-RepairCommand <String>]
[-RepairWorkingDirectory <String>]
[-RequireUserInteraction <Boolean>]
[-ScriptFile <String>]
[-ScriptLanguage <ScriptLanguage>]
[-ScriptText <String>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-SourceUpdateProductCode <String>]
[-UninstallCommand <String>]
[-UninstallContentLocation <String>]
[-UninstallOption <UninstallContentSetting>]
[-UninstallWorkingDirectory <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>]
Set-CMScriptDeploymentType
[-ContentLocation <String>]
[-AddDetectionClause <DetectionClause[]>]
[-CacheContent <Boolean>]
[-ContentFallback <Boolean>]
[-DetectionClauseConnector <Hashtable[]>]
[-EnableBranchCache <Boolean>]
[-EstimatedRuntimeMins <Int32>]
[-Force32Bit <Boolean>]
[-ForceScriptDetection32Bit <Boolean>]
[-GroupDetectionClauses <String[]>]
[-InstallationBehaviorType <InstallationBehaviorType>]
[-InstallCommand <String>]
[-InstallWorkingDirectory <String>]
[-LogonRequirementType <LogonRequirementType>]
[-MaximumRuntimeMins <Int32>]
[-ProductCode <String>]
[-RebootBehavior <PostExecutionBehavior>]
[-RemoveDetectionClause <String[]>]
[-RepairCommand <String>]
[-RepairWorkingDirectory <String>]
[-RequireUserInteraction <Boolean>]
[-ScriptFile <String>]
[-ScriptLanguage <ScriptLanguage>]
[-ScriptText <String>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-SourceUpdateProductCode <String>]
[-UninstallCommand <String>]
[-UninstallContentLocation <String>]
[-UninstallOption <UninstallContentSetting>]
[-UninstallWorkingDirectory <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>]
Set-CMScriptDeploymentType
[-ContentLocation <String>]
[-AddDetectionClause <DetectionClause[]>]
[-CacheContent <Boolean>]
[-ContentFallback <Boolean>]
[-DetectionClauseConnector <Hashtable[]>]
[-EnableBranchCache <Boolean>]
[-EstimatedRuntimeMins <Int32>]
[-Force32Bit <Boolean>]
[-ForceScriptDetection32Bit <Boolean>]
[-GroupDetectionClauses <String[]>]
[-InstallationBehaviorType <InstallationBehaviorType>]
[-InstallCommand <String>]
[-InstallWorkingDirectory <String>]
[-LogonRequirementType <LogonRequirementType>]
[-MaximumRuntimeMins <Int32>]
[-ProductCode <String>]
[-RebootBehavior <PostExecutionBehavior>]
[-RemoveDetectionClause <String[]>]
[-RepairCommand <String>]
[-RepairWorkingDirectory <String>]
[-RequireUserInteraction <Boolean>]
[-ScriptFile <String>]
[-ScriptLanguage <ScriptLanguage>]
[-ScriptText <String>]
[-SlowNetworkDeploymentMode <ContentHandlingMode>]
[-SourceUpdateProductCode <String>]
[-UninstallCommand <String>]
[-UninstallContentLocation <String>]
[-UninstallOption <UninstallContentSetting>]
[-UninstallWorkingDirectory <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
Utilize este cmdlet para configurar as definições para um tipo de implementação do Instalador de Scripts de uma aplicação do Configuration Manager. Este tipo de implementação pode ser um script ou um programa que instala conteúdos ou efetua uma ação. Utilize este tipo de implementação para instaladores setup.exe ou wrappers de script.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Modificar um tipo de implementação do instalador de scripts
Este comando adiciona um comando de desinstalação ao tipo de implementação com o nome ScriptDT01 para a aplicação com o nome Application01.
Set-CMScriptDeploymentType -ApplicationName "Application01" -DeploymentTypeName "ScriptDT01" -Comment "Script updated to uninstall" -UninstallCommand 'msiexec /x ""\\Machine01\Resources\Applications\MSI\AdvertMSI\AdvertMSI.msi" /q'
Exemplo 2: Adicionar um método de deteção
Este exemplo utiliza primeiro o cmdlet New-CMDetectionClauseFile para criar três cláusulas de deteção baseadas em ficheiros para o ficheiro c:\abc\abc com um tamanho de 1 KB, 2 KB e 4 KB.
Em seguida, configura o tipo de implementação para adicionar estas cláusulas como um método de deteção. Também agrupa a segunda e terceira cláusulas com um conector OR .
$clauseFile1 = New-CMDetectionClauseFile -FileName "abc" -Path "c:\abc" -PropertyType Size -ExpectedValue 1024 -ExpressionOperator IsEquals -Value
$clauseFile2 = New-CMDetectionClauseFile -FileName "abc" -Path "c:\abc" -PropertyType Size -ExpectedValue 2048 -ExpressionOperator IsEquals -Value
$clauseFile3 = New-CMDetectionClauseFile -FileName "abc" -Path "c:\abc" -PropertyType Size -ExpectedValue 4096 -ExpressionOperator IsEquals -Value
Set-CMScriptDeploymentType -ApplicationName "testApp1" -DeploymentTypeName "abc" -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3 -DetectionClauseConnector @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"} -GroupDetectionClauses $clauseFile2.Setting.LogicalName, $clauseFile3.Setting.LogicalName
Exemplo 3: Adicionar uma regra de requisito de idioma
Este exemplo configura a aplicação com uma regra de requisito para a languge do SO.
$myGC = Get-CMGlobalCondition -Name "Operating System Language" | Where-Object PlatformType -eq 1
$cultureA = [System.Globalization.CultureInfo]::GetCultures([System.Globalization.CultureTypes]::AllCultures) | Where-Object Name -eq "zh"
$cultureB = [System.Globalization.CultureInfo]::GetCultures([System.Globalization.CultureTypes]::AllCultures) | Where-Object Name -eq "zh-CN"
$myRule = $myGC | New-CMRequirementRuleOperatingSystemLanguageValue -RuleOperator NoneOf -Culture $cultureA,$cultureB -IsMobile $False
Set-CMScriptDeploymentType -ApplicationName "myApp" -DeploymentTypeName "myDT" -AddRequirement $myRule
Exemplo 4: Adicionar uma regra de requisito
Este exemplo configura a aplicação com uma regra de requisito de que a memória física é superior a 2 GB.
$rule1 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 2048 -RuleOperator GreaterEquals
$myRuleExpression = New-CMRequirementRuleExpression -AddRequirementRule $rule1
$myGC = New-CMGlobalConditionExpression -Name "GCExp" -DeviceType Windows -RootExpression $myRuleExpression
Set-CMScriptDeploymentType -ApplicationName "myApp" -DeploymentTypeName "myDT" -AddRequirement $myGC
Parâmetros
-AddDetectionClause
Especifique uma matriz de cláusulas de método de deteção para este tipo de implementação. Para criar uma cláusula de deteção, utilize um dos seguintes cmdlets:
- New-CMDetectionClauseDirectory
- New-CMDetectionClauseFile
- New-CMDetectionClauseRegistryKey
- New-CMDetectionClauseRegistryKeyValue
- New-CMDetectionClauseWindowsInstaller
Guarde a saída destes cmdlets numa variável. Em seguida, especifique essas variáveis como uma matriz para este parâmetro. Por exemplo, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3
.
Também pode utilizar Get-CMDeploymentTypeDetectionClause para obter uma cláusula de deteção existente de outra aplicação.
Tipo: | DetectionClause[] |
Aliases: | AddDetectionClauses |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AddLanguage
Especifique uma matriz de etiquetas de idioma que o tipo de implementação suporta. Por exemplo, para adicionar russo (Rússia), especifique a etiqueta ru-RU
.
Para obter mais informações e uma lista de etiquetas de idioma, consulte Referência do Identificador de Código de Idioma (LCID) do Windows.
Tipo: | String[] |
Aliases: | AddLanguages, Languages, Language |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AddRequirement
Especifique uma matriz de objetos de requisitos para o tipo de implementação. Para criar um objeto de regra de requisito, utilize um dos seguintes cmdlets:
- New-CMRequirementRuleActiveDirectorySiteValue
- New-CMRequirementRuleBooleanValue
- New-CMRequirementRuleCMSiteValue
- New-CMRequirementRuleCommonValue
- New-CMRequirementRuleDeviceOwnershipValue
- New-CMRequirementRuleExistential
- New-CMRequirementRuleExpression
- New-CMRequirementRuleFileAttributeValue
- New-CMRequirementRuleFilePermissionValue
- New-CMRequirementRuleFreeDiskSpaceValue
- New-CMRequirementRuleInputTypeValue
- New-CMRequirementRuleOperatingSystemLanguageValue
- New-CMRequirementRuleOperatingSystemValue
- New-CMRequirementRuleOUValue
- New-CMRequirementRuleRegistryKeyPermissionValue
- New-CMRequirementRuleScreenResolutionValue
A partir da versão 2111, pode utilizar o cmdlet Get-CMDeploymentTypeRequirement para copiar regras de outro tipo de implementação.
Tipo: | Rule[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Application
Especifique um objeto de aplicação para este tipo de implementação. Para obter este objeto, utilize o cmdlet Get-CMApplication .
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ApplicationId
Especifique o ID da aplicação para este tipo de implementação.
Tipo: | Int32 |
Aliases: | CI_ID, CIId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ApplicationName
Especifique o nome da aplicação para este tipo de implementação.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CacheContent
Defina este parâmetro como $true
para guardar conteúdo indefinidamente na cache do cliente.
Tipo: | Boolean |
Aliases: | PersistContentInClientCache |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Comment
Especifique uma descrição opcional para o tipo de implementação.
Tipo: | String |
Aliases: | AdministratorComment |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContentFallback
Se definir este parâmetro como $true
, quando o conteúdo não estiver disponível em quaisquer pontos de distribuição nos grupos de limites atuais ou vizinhos do cliente, o cliente pode utilizar pontos de distribuição no grupo de limites predefinido do site.
Tipo: | Boolean |
Aliases: | EnableContentLocationFallback, AllowClientsToUseFallbackSourceLocationForContent |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContentLocation
Especifica o caminho de origem de rede do conteúdo. O servidor do sistema de sites requer permissão para ler os ficheiros de conteúdo.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeploymentTypeName
Especifique o nome do tipo de implementação a configurar.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DetectionClauseConnector
Quando utilizar o parâmetro GroupDetectionClauses para agrupar cláusulas de deteção, utilize este parâmetro para especificar o conector.
O exemplo seguinte define o conector OR : @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}
Tipo: | Hashtable[] |
Aliases: | DetectionClauseConnectors |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EnableBranchCache
Este parâmetro foi preterido. O BranchCache está sempre ativado nos clientes e utiliza-o se o ponto de distribuição o suportar.
Tipo: | Boolean |
Aliases: | AllowClientsToShareContentOnSameSubnet |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EstimatedRuntimeMins
Especifique o tempo estimado de instalação, em minutos, deste tipo de implementação para a aplicação. O Centro de Software apresenta esta estimativa ao utilizador antes da instalação da aplicação.
Tipo: | Int32 |
Aliases: | EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do utilizador.
Tipo: | SwitchParameter |
Aliases: | ForceForUnknownPublisher |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Force32Bit
Defina este parâmetro para $true
executar os programas de instalação e desinstalação como processos de 32 bits em clientes de 64 bits.
Tipo: | Boolean |
Aliases: | Force32BitInstaller |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceScriptDetection32Bit
Se utilizar um script personalizado para detetar a presença deste tipo de implementação, defina este parâmetro para $true
executar o script como um processo de 32 bits em clientes de 64 bits.
Tipo: | Boolean |
Aliases: | Force32BitDetectionScript |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-GroupDetectionClauses
Quando configurar regras para detetar a presença deste tipo de implementação, utilize este parâmetro para agrupar cláusulas. Para criar uma cláusula de deteção, utilize um dos seguintes cmdlets:
- New-CMDetectionClauseDirectory
- New-CMDetectionClauseFile
- New-CMDetectionClauseRegistryKey
- New-CMDetectionClauseRegistryKeyValue
- New-CMDetectionClauseWindowsInstaller
Guarde a saída destes cmdlets numa variável. Em seguida, utilize o seguinte formato para agrupar cláusulas: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName
.
Dica
Na consola do Configuration Manager, quando seleciona a ação Grupo , as cláusulas mostram parênteses antes e depois das cláusulas agrupadas.
Tipo: | String[] |
Aliases: | GroupDetectionClausesByLogicalName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Especifique um objeto de tipo de implementação a configurar. Para obter este objeto, utilize o cmdlet Get-CMDeploymentType .
Tipo: | IResultObject |
Aliases: | DeploymentType |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-InstallationBehaviorType
Especifique o comportamento de instalação para este tipo de implementação:
-
InstallForUser
: o cliente só instala a aplicação para o utilizador a quem implementa a aplicação. -
InstallForSystem
: o cliente instala a aplicação apenas uma vez. Está disponível para todos os utilizadores. -
InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
: se implementar a aplicação num dispositivo, o cliente instala-a para todos os utilizadores. Se implementar a aplicação num utilizador, o cliente só a instala para esse utilizador.
Tipo: | InstallationBehaviorType |
Valores aceitos: | InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InstallCommand
Especifique a linha de comandos do programa de instalação para instalar esta aplicação.
Tipo: | String |
Aliases: | InstallationProgram |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InstallWorkingDirectory
Especifique o caminho a utilizar como diretório de trabalho quando o cliente executar o InstallCommand.
Tipo: | String |
Aliases: | InstallationStartIn, InstallFolder |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-LogonRequirementType
Especifique o requisito para um utilizador com sessão iniciada:
OnlyWhenNoUserLoggedOn
: apenas quando nenhum utilizador tiver sessão iniciada no Windows.OnlyWhenUserLoggedOn
: apenas quando um utilizador tem sessão iniciada. Esta é a opção padrão.WhetherOrNotUserLoggedOn
: se um utilizador tem ou não sessão iniciada.Observação
O valor
WhereOrNotUserLoggedOn
foi preterido. É substituído porWhetherOrNotUserLoggedOn
.
Se definir InstallationBehaviorType como InstallForUser
, não poderá definir este parâmetro.
Tipo: | LogonRequirementType |
Valores aceitos: | OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MaximumRuntimeMins
Especifique o tempo máximo de execução permitido do programa de implementação para esta aplicação. Defina um valor inteiro em minutos.
Tipo: | Int32 |
Aliases: | MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-NewName
Especifique um novo nome para mudar o nome deste tipo de implementação.
Tipo: | String |
Aliases: | NewDeploymentTypeName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PassThru
Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProductCode
Se a aplicação utilizar a tecnologia Windows Installer, especifique um código de produto MSI para definir como método de deteção. Quando utiliza este parâmetro, substitui todos os métodos de deteção existentes.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RebootBehavior
Especifique o comportamento pós-instalação:
BasedOnExitCode
: determine o comportamento com base nos códigos de retorno.NoAction
: Nenhuma ação específica.ProgramReboot
: o programa de instalação de software pode forçar o reinício do dispositivo.ForceReboot
: o cliente do Configuration Manager forçará um reinício obrigatório do dispositivo.
Para obter mais informações sobre estes comportamentos, veja Criar aplicações no Configuration Manager.
Tipo: | PostExecutionBehavior |
Valores aceitos: | BasedOnExitCode, NoAction, ForceReboot, ProgramReboot |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RemoveDetectionClause
Especifique uma matriz de cláusulas de método de deteção a remover.
Tipo: | String[] |
Aliases: | RemoveDetectionClauses |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RemoveLanguage
Especifique uma matriz de idiomas suportados a remover deste tipo de implementação.
Tipo: | String[] |
Aliases: | RemoveLanguages |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RemoveRequirement
Especifique uma matriz de regras de requisitos a remover deste tipo de implementação.
Tipo: | Rule[] |
Aliases: | RemoveRequirements |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RepairCommand
Utilize este parâmetro para configurar o comando de reparação. Configure também o parâmetro RepairWorkingDirectory .
A partir da versão 2006, pode especificar uma cadeia vazia.
Tipo: | String |
Aliases: | RepairProgram |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RepairWorkingDirectory
Utilize este parâmetro para configurar o diretório de trabalho do comando de reparação. Configure também o parâmetro RepairCommand .
Tipo: | String |
Aliases: | RepairStartIn, RepairFolder |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RequireUserInteraction
Defina este parâmetro como para $true
permitir que os utilizadores vejam e interajam com a instalação do tipo de implementação.
Tipo: | Boolean |
Aliases: | RequiresUserInteraction |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ScriptFile
Especifique o ficheiro de script a utilizar para detetar este tipo de implementação. Utilize também o parâmetro ScriptLanguage .
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ScriptLanguage
Se utilizar os parâmetros ScriptFile ou ScriptText , utilize este parâmetro para especificar a linguagem de script.
Tipo: | ScriptLanguage |
Aliases: | ScriptType |
Valores aceitos: | PowerShell, VBScript, JavaScript |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ScriptText
Especifique o texto de um script para detetar este tipo de implementação. Utilize também o parâmetro ScriptLanguage .
Para obter mais informações, veja About custom script detection methods (Acerca dos métodos de deteção de scripts personalizados).
Tipo: | String |
Aliases: | ScriptContent, Script |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SlowNetworkDeploymentMode
Quando um cliente utiliza um ponto de distribuição de um grupo de limites de vizinhos ou o grupo de limites de site predefinido, especifique a opção de implementação:
-
DoNothing
: Não transferir conteúdo -
Download
: transfira conteúdo do ponto de distribuição e execute localmente
Tipo: | ContentHandlingMode |
Valores aceitos: | DoNothing, Download |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SourceUpdateProductCode
Se a aplicação utilizar a tecnologia Windows Installer, especifique um código de produto MSI. Este código de produto é um formato GUID.
A gestão da Origem do Windows permite que um .MSI representado por este tipo de implementação seja automaticamente atualizado ou reparado a partir de ficheiros de origem de conteúdo num ponto de distribuição disponível.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UninstallCommand
Especifica a linha de comandos para desinstalar a aplicação.
A partir da versão 2006, pode especificar uma cadeia vazia.
Tipo: | String |
Aliases: | UninstallationProgram |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UninstallContentLocation
Especifique o caminho de rede para o conteúdo de origem a utilizar com o Comando Desinstalar diferente do ContentLocation. Utilize este parâmetro quando definir UninstallOption como Different
.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UninstallOption
Especifique o conteúdo a utilizar com UninstallCommand:
-
SameAsInstall
: os conteúdos de instalação e desinstalação são os mesmos. Esta é a opção padrão. -
NoneRequired
: a aplicação não precisa de conteúdo para desinstalar. -
Different
: o conteúdo de desinstalação é diferente do conteúdo de instalação. Utilize UninstallContentLocation para especificar o caminho de rede para o conteúdo utilizado para desinstalar a aplicação.
Tipo: | UninstallContentSetting |
Valores aceitos: | SameAsInstall, NoneRequired, Different |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UninstallWorkingDirectory
Especifique o caminho a utilizar como diretório de trabalho quando o cliente executar o UninstallCommand.
Tipo: | String |
Aliases: | UninstallationStartIn, UninstallFolder |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserInteractionMode
Especifique a visibilidade do programa de instalação:
-
Normal
: o tipo de implementação é executado no modo normal com base nas predefinições do sistema e do programa. Este modo é a predefinição. -
Minimized
: o tipo de implementação é executado minimizado em dispositivos cliente. Os utilizadores podem ver a atividade de instalação na área de notificação ou na barra de tarefas. -
Maximized
: o tipo de implementação é executado maximizado em dispositivos cliente. Os utilizadores veem toda a atividade de instalação. -
Hidden
: o tipo de implementação é executado oculto em dispositivos cliente. Os utilizadores não veem nenhuma atividade de instalação.
Tipo: | UserInteractionMode |
Aliases: | InstallationProgramVisibility |
Valores aceitos: | Normal, Minimized, Maximized, Hidden |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object