Freigeben über

Remove-CMComputerAssociation

  • Referenz
Modul:
ConfigurationManager

Löscht eine Computerzuordnung aus 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>]

Beschreibung

Das Cmdlet Remove-CMComputerAssociation löscht eine Computerzuordnung aus Configuration Manager. Sie können die zu entfernende Zuordnung angeben, indem Sie beide Computer in der Zuordnung oder die Zuordnungs-ID angeben, oder Sie können das Cmdlet Get-CMComputerAssociation verwenden, um eine zu entfernende Zuordnung abzurufen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Entfernen einer Zuordnung mithilfe von Computernamen

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

Dieser Befehl entfernt die Computerzuordnung zwischen den Computern "West155" und "West073".

Beispiel 2: Entfernen einer Zuordnung mithilfe einer ID

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

Mit diesem Befehl wird die Computerzuordnung entfernt, die über die ID MID1207 verfügt. Dieser Befehl verwendet den Force-Parameter , sodass Sie vom Cmdlet nicht zur Bestätigung aufgefordert werden, bevor die Zuordnung entfernt wird.

Beispiel 3: Entfernen einer Zuordnung mithilfe einer Variablen

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

Der erste Befehl ruft die Computerzuordnung ab, die über die ID MID1207 verfügt, und speichert sie in der variablen $CMCA.

Der zweite Befehl entfernt die in der $CMCA Variable gespeicherte Zuordnung. Dieser Befehl verwendet den Force-Parameter , sodass Sie vom Cmdlet nicht zur Bestätigung aufgefordert werden, bevor die Zuordnung entfernt wird.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DestinationComputer

Gibt den Namen eines Zielcomputers an.

Typ:String
Aliase:RestoreName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Computerzuordnungsobjekt an. Verwenden Sie zum Abrufen eines Computerzuordnungsobjekts das Cmdlet Get-CMComputerAssociation.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MigrationId

Gibt die ID einer Computerzuordnung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SourceComputer

Gibt den Namen des Quellcomputers an.

Typ:String
Aliase:SourceName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object