Freigeben über

Remove-CMStateMigrationPoint

  • Referenz
Modul:
ConfigurationManager

Entfernt einen Zustandsmigrationspunkt von einem Configuration Manager-Standort.

Syntax

Remove-CMStateMigrationPoint
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMStateMigrationPoint
      [-Force]
      [-SiteCode <String>]
      [-SiteSystemServerName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMStateMigrationPoint entfernt einen Zustandsmigrationspunkt von einem Configuration Manager-Standort. Diese Standortsystemrolle speichert Benutzerinformationen, während Sie eine Betriebssystembereitstellung durchführen. Wenn Sie einen Zustandsmigrationspunkt entfernen, entfernen Sie auch alle zugehörigen gespeicherten Benutzerinformationen.

Jeder Zustandsmigrationspunkt kann nur Mitglied eines Configuration Manager-Standorts sein.

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 eines angegebenen Migrationspunkts

PS XYZ:\> Remove-CMStateMigrationPoint -SiteCode "CM1" -SiteSystemServerName "SMP01.Western.Contoso.com"

Dieser Befehl entfernt einen Zustandsmigrationspunkt, der zu dem Standort gehört, der über den Standortcode CM1 verfügt. Der Befehl gibt den Namen des Computers an, auf dem die Standortsystemrolle gehostet wird.

Beispiel 2: Entfernen eines Migrationspunkts mithilfe einer Variablen

PS XYZ:\> $CMSMP = Get-CMStateMigrationPoint -SiteCode "CM1" -SiteSystemServerName "SMP01.TSQA.Contoso.com"
PS XYZ:\> Remove-CMStateMigrationPoint -InputObject $CMSMP

Der erste Befehl verwendet die Get-CMStateMigrationPoint, um einen Zustandsmigrationspunkt abzurufen, der zum angegebenen Standort gehört und über den angegebenen Hostnamen verfügt, und speichert dieses Objekt dann in der $CMSMP Variablen.

Der zweite Befehl entfernt den zustandsmigrationspunkt, der in der variablen $CMSMP gespeichert ist.

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

-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 Zustandsmigrationspunktobjekt an. Verwenden Sie das Cmdlet Get-CMStateMigrationPoint, um ein Zustandsmigrationspunktobjekt abzurufen.

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

-SiteCode

Gibt einen Standortcode für einen Configuration Manager-Standort an.

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

-SiteSystemServerName

Gibt den Hostnamen für einen Zustandsmigrationspunkt an.

Typ:String
Aliase:Name, ServerName
Position:0
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