Add-CMMsiDeploymentType

Módulo:

ConfigurationManager

Adicione um tipo de implementação do Windows Installer.

Sintaxe

Add-CMMsiDeploymentType
   -ApplicationName <String>
   [-CacheContent]
   [-ContentFallback]
   -ContentLocation <String>
   [-DeploymentTypeName <String>]
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   [-InstallCommand <String>]
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationId <Int32>
   [-CacheContent]
   [-ContentFallback]
   [-ContentLocation <String>]
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallCommand <String>
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationName <String>
   [-CacheContent]
   [-ContentFallback]
   [-ContentLocation <String>]
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallCommand <String>
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   -AddDetectionClause <DetectionClause[]>
   [-CacheContent]
   [-ContentFallback]
   [-ContentLocation <String>]
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-GroupDetectionClauses <String[]>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallCommand <String>
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   -ApplicationId <Int32>
   [-CacheContent]
   [-ContentFallback]
   [-ContentLocation <String>]
   -DeploymentTypeName <String>
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallCommand <String>
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   -ApplicationId <Int32>
   [-CacheContent]
   [-ContentFallback]
   -ContentLocation <String>
   [-DeploymentTypeName <String>]
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   [-InstallCommand <String>]
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   -ApplicationName <String>
   [-CacheContent]
   [-ContentFallback]
   [-ContentLocation <String>]
   -DeploymentTypeName <String>
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallCommand <String>
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   [-CacheContent]
   [-ContentFallback]
   [-ContentLocation <String>]
   -DeploymentTypeName <String>
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   [-ForceScriptDetection32Bit]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallCommand <String>
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMMsiDeploymentType
   [-CacheContent]
   [-ContentFallback]
   -ContentLocation <String>
   [-DeploymentTypeName <String>]
   [-EnableBranchCache]
   [-EstimatedRuntimeMins <Int32>]
   [-Force32Bit]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   [-InstallCommand <String>]
   [-InstallWorkingDirectory <String>]
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RepairCommand <String>]
   [-RepairWorkingDirectory <String>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-SourceUpdateProductCode <String>]
   [-UninstallCommand <String>]
   [-UninstallContentLocation <String>]
   [-UninstallOption <UninstallContentSetting>]
   [-UninstallWorkingDirectory <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para adicionar um tipo de implementação do Windows Installer (MSI) a uma aplicação.

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: Adicionar um tipo de implementação

Este comando adiciona o tipo de implementação Windows Installer denominado DTMsi da localização especificada à aplicação com o nome testMsi. Este tipo de implementação suporta inglês (Estados Unidos) (en-US) e chinês (simplificado) (zh-CN).

Add-CMMSiDeploymentType -ApplicationName "testMsi" -DeploymentTypeName "DTMsi" -ContentLocation "\\Server1\Applications\MSI\32BitSDK\32BitCompat.msi" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type"

Exemplo 2: Adicionar um método de deteção

Este exemplo adiciona uma cláusula de deteção que requer a existência de um ID de produto específico e um nome de diretório.

$app = Get-CMApplication -ApplicationName "CentralApp"
$guid = "9900a338-484b-4a18-884e-bce87654ce1b"
$clause1 = New-CMDetectionClauseWindowsInstaller -ProductCode $guid -Value -ExpressionOperator IsEquals -ExpectedValue "1.1.1.1"
$clause2 = New-CMDetectionClauseDirectory -DirectoryName "mymsi" -Path "C:\" -Existence

$app | Add-CMMsiDeploymentType -ContentLocation "\\myserver\mypath\mymsi.msi" -Force -AddDetectionClause ($clause1, $clause2)

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

-ApplicationId

Especifique o ID da aplicação para este tipo de implementação.

Tipo:	Int32
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:	SwitchParameter
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:	SwitchParameter
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 ficheiro MSI. O servidor do sistema de sites requer permissão para ler os ficheiros de conteúdo.

Tipo:	String
Aliases:	InstallationFileLocation
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DeploymentTypeName

Especifique um nome a apresentar 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

-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:	SwitchParameter
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:	SwitchParameter
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:	SwitchParameter
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 aplicação a configurar. Para obter este objeto, utilize o cmdlet Get-CMApplication .

Tipo:	IResultObject
Aliases:	Application
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 o pacote do Windows Installer.

Tipo:	String
Aliases:	InstallationProgram
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
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 por WhetherOrNotUserLoggedOn.

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

-ProductCode

Especifique o código de produto MSI a definir como o método de deteção. Quando utiliza este parâmetro, este substitui quaisquer outros métodos de deteção.

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

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

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

Links Relacionados

• Set-CMMsiDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• Criar aplicações no Configuration Manager