Remove-CMComputerAssociation

コンピューターの関連付けをConfiguration Managerから削除します。

構文

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>]

説明

Remove-CMComputerAssociation コマンドレットは、コンピューターの関連付けをConfiguration Managerから削除します。 関連付けで両方のコンピューターを指定するか、関連付け ID を指定して削除する関連付けを指定するか、 Get-CMComputerAssociation コマンドレットを使用して削除する関連付けを取得できます。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例 1: コンピューター名を使用して関連付けを削除する

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

このコマンドは、West155 と West073 という名前のコンピューター間のコンピューターの関連付けを削除します。

例 2: ID を使用して関連付けを削除する

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

このコマンドは、ID MID1207 を持つコンピューターの関連付けを削除します。 このコマンドは Force パラメーターを使用するため、コマンドレットは関連付けを削除する前に確認を求めないようにします。

例 3: 変数を使用して関連付けを削除する

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

最初のコマンドは、ID MID1207 を持つコンピューターの関連付けを取得し、$CMCA変数に保存します。

2 番目のコマンドは、$CMCA変数に保存されている関連付けを削除します。 このコマンドは Force パラメーターを使用するため、コマンドレットは関連付けを削除する前に確認を求めないようにします。

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-DestinationComputer

対象のコンピューターの名前を指定します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-InputObject

コンピューターの関連付けオブジェクトを指定します。 コンピューターの関連付けオブジェクトを取得するには、Get-CMComputerAssociation コマンドレットを使用します。

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

-MigrationId

コンピューターの関連付けの ID を指定します。

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

-SourceComputer

ソース コンピューターの名前を指定します。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object