Share via

Remove-CMComputerAssociation

  • Referência
Módulo:
ConfigurationManager

Exclui uma associação de computador de Configuration Manager.

Syntax

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 exclui uma associação de computador de Configuration Manager. Você pode especificar a associação a ser removida especificando os dois computadores na associação ou especificando a ID da associação ou pode usar o cmdlet Get-CMComputerAssociation para obter uma associação a ser removida.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover uma associação usando nomes de computador

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

Esse comando remove a associação de computador entre os computadores chamados West155 e West073.

Exemplo 2: remover uma associação usando uma ID

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

Esse comando remove a associação de computador que tem a ID MID1207. Esse comando usa o parâmetro Force para que o cmdlet não solicite a confirmação antes de remover a associação.

Exemplo 3: remover uma associação usando 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 computador que tem a ID MID1207 e a salva na variável $CMCA.

O segundo comando remove a associação salva na variável $CMCA. Esse comando usa o parâmetro Force para que o cmdlet não solicite a confirmação antes de remover a associação.

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationComputer

Especifica o nome de um computador de destino.

Type:String
Aliases:RestoreName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-InputObject

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

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

-MigrationId

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

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

-SourceComputer

Especifica o nome do computador de origem.

Type:String
Aliases:SourceName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object