Set-CMApplicationSupersedence

  • Referência
Módulo:
ConfigurationManager

Definir substituição do tipo de implementação para uma aplicação.

Sintaxe

Set-CMApplicationSupersedence
   [-Id] <Int32>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplicationSupersedence
   [-Name] <String>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplicationSupersedence
   [-InputObject] <IResultObject>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para definir a substituição do tipo de implementação para a aplicação especificada.

Para obter mais informações, veja Substituir aplicações.

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 substituição do tipo de implementação

$AppSupersededName = "Superseded app"
$AppSuperseded = New-CMApplication -Name $AppSupersededName
$OriginalDT = Add-CMScriptDeploymentType -ApplicationName $AppSuperseded -DeploymentTypeName "ScriptDT01" -InstallCommand 'appsetup.exe'

$AppSupersedingName = "Superseding app"
$AppSuperseding = New-CMApplication -Name $AppSupersedingName
$AppSupersedingDT = Add-CMScriptDeploymentType -ApplicationName $AppSuperseding -DeploymentTypeName "ScriptDT02" -InstallCommand 'appsetup2.exe'

Set-CMApplicationSupersedence -ApplicationId ($AppSuperseding.CI_ID) -CurrentDeploymentTypeId ($AppSupersedingDT.CI_ID) -SupersededApplicationId ($AppSuperseded.CI_ID) -OldDeploymentTypeId ($OriginalDT.CI_ID)

Exemplo 2: Remover substituição do tipo de implementação

Set-CMApplicationSupersedence -ApplicationName $AppSupersedingName -CurrentDeploymentTypeName ($AppSupersedingDT.LocalizedDisplayName) -SupersededApplicationName $AppSupersededName -OldDeploymentTypeName ($OriginalDT.LocalizedDisplayName) -RemoveSupersedence -Force

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-CurrentDeploymentType

Especifique um objeto de tipo de implementação da aplicação de substituição . Para obter este objeto, utilize o cmdlet Get-CMDeploymentType .

Tipo:IResultObject
Aliases:ReplacementDeploymentType, SupersedingDeploymentType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CurrentDeploymentTypeId

Especifique o ID de um tipo de implementação da aplicação de substituição .

Tipo:Int32
Aliases:CurrentDeploymentTypeCIId, CurrentDeploymentTypeCI_ID, ReplacementDeploymentTypeId, ReplacementDeploymentTypeCIId, ReplacementDeploymentTypeCI_ID, SupersedingDeploymentTypeId, SupersedingDeploymentTypeCIId, SupersedingDeploymentTypeCI_ID
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CurrentDeploymentTypeName

Especifique o nome de um tipo de implementação da aplicação de substituição .

Tipo:String
Aliases:ReplacementDeploymentTypeName, SupersedingDeploymentTypeName
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

-Force

Adicione este parâmetro para executar o comando sem pedir confirmação.

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

-Id

Especifique o ID da aplicação atual (substituição).

Tipo:Int32
Aliases:ApplicationId, CurrentApplicationId, CurrentApplicationCIId, CurrentApplicationCI_ID
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto para a aplicação atual (substituição). Para obter este objeto, utilize o cmdlet Get-CMApplication .

Tipo:IResultObject
Aliases:Application, CurrentApplication
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IsUninstall

Defina este parâmetro como $true para desinstalar a aplicação sobreposta antes de o cliente instalar a aplicação de substituição.

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

-Name

Especifique o nome a apresentar localizado da aplicação atual (substituição).

Tipo:String
Aliases:ApplicationName, LocalizedDisplayName, CurrentApplicationName, CurrentApplicationLocalizedDisplayName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OldDeploymentType

Especifique um objeto de tipo de implementação da aplicação sobreposta . Para obter este objeto, utilize o cmdlet Get-CMDeploymentType .

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

-OldDeploymentTypeId

Especifique o ID de um tipo de implementação da aplicação sobreposta .

Tipo:Int32
Aliases:OldDeploymentTypeCIId, OldDeploymentTypeCI_ID, SupersededDeploymentTypeId, SupersededDeploymentTypeCIId, SupersededDeploymentTypeCI_ID
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OldDeploymentTypeName

Especifique o nome de um tipo de implementação da aplicação substituído .

Tipo:String
Aliases:SupersededDeploymentTypeName
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

-RemoveSupersedence

Adicione este parâmetro para remover a relação de substituição.

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

-SupersededApplication

Especifique um objeto para a aplicação antiga (substituído). Para obter este objeto, utilize o cmdlet Get-CMApplication .

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

-SupersededApplicationId

Especifique o ID da aplicação antiga (sobreposta).

Tipo:Int32
Aliases:SupersededApplicationCIId, SupersededApplicationCI_ID
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SupersededApplicationName

Especifique o nome a apresentar localizado da aplicação antiga (substituído).

Tipo:String
Aliases:SupersededApplicationLocalizedDisplayName
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:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object