Compartilhar via

Remove-CMComputerAssociation

  • Referência
Módulo:
ConfigurationManager

Elimina uma associação de computador do Configuration Manager.

Sintaxe

Remove-CMComputerAssociation
      -DestinationComputer <String>
      [-Force]
      -SourceComputer <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMComputerAssociation
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMComputerAssociation
      [-Force]
      -MigrationId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-CMComputerAssociation elimina uma associação de computador do Configuration Manager. Pode especificar a associação a remover ao especificar ambos os computadores na associação ou ao especificar o ID de associação ou pode utilizar o cmdlet Get-CMComputerAssociation para obter uma associação a remover.

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: Remover uma associação com nomes de computador

PS XYZ:\> Remove-CMComputerAssociation -DestinationComputer "West155" -SourceComputer "West073"

Este comando remove a associação de computadores entre os computadores denominados West155 e West073.

Exemplo 2: Remover uma associação com um ID

PS XYZ:\> Remove-CMComputerAssociation -MigrationId "MID1207" -Force

Este comando remove a associação de computadores que tem o ID MID1207. Este comando utiliza o parâmetro Force , pelo que o cmdlet não lhe pede confirmação antes de remover a associação.

Exemplo 3: Remover uma associação com uma variável

PS XYZ:\> $CMCA = Get-CMComputerAssociation -MigrationId "MID1207"
PS XYZ:\> Remove-CMComputerAssociation -InputObject $CMCA -Force

O primeiro comando obtém a associação de computadores que tem o ID MID1207 e guarda-o na variável $CMCA.

O segundo comando remove a associação guardada na variável $CMCA. Este comando utiliza o parâmetro Force , pelo que o cmdlet não lhe pede confirmação antes de remover a associação.

Parâmetros

-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

-DestinationComputer

Especifica o nome de um computador de destino.

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

Força o comando a ser executado sem pedir a confirmação do utilizador.

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

-InputObject

Especifica um objeto de associação de computador. Para obter um objeto de associação de computador, utilize o cmdlet Get-CMComputerAssociation.

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

-MigrationId

Especifica o ID de uma associação de computador.

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

-SourceComputer

Especifica o nome do computador de origem.

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