Freigeben über

Set-CMStateMigrationPoint

  • Referenz
Modul:
ConfigurationManager

Ändert Einstellungen für einen Zustandsmigrationspunkt in Configuration Manager.

Syntax

Set-CMStateMigrationPoint
   [-AddBoundaryGroupName <String[]>]
   [-AddStorageFolder <StorageDirectoryData[]>]
   [-AllowFallbackSourceLocationForContent <Boolean>]
   [-DeleteImmediately]
   [-EnableRestoreOnlyMode <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-RemoveBoundaryGroupName <String[]>]
   [-RemoveStorageFolder <StorageDirectoryData[]>]
   [-TimeDeleteAfter <Int32>]
   [-TimeUnit <IntervalType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMStateMigrationPoint
   [-AddBoundaryGroupName <String[]>]
   [-AddStorageFolder <StorageDirectoryData[]>]
   [-AllowFallbackSourceLocationForContent <Boolean>]
   [-DeleteImmediately]
   [-EnableRestoreOnlyMode <Boolean>]
   [-PassThru]
   [-RemoveBoundaryGroupName <String[]>]
   [-RemoveStorageFolder <StorageDirectoryData[]>]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-TimeDeleteAfter <Int32>]
   [-TimeUnit <IntervalType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMStateMigrationPoint ändert Einstellungen für einen Zustandsmigrationspunkt in Configuration Manager. Ein Zustandsmigrationspunkt ist eine Standortsystemrolle, die die Datenübertragung von Clientcomputern während eines Betriebssysteminstallationsprozesses verwaltet. Verwenden Sie dieses Cmdlet, um die Begrenzungsgruppen und Speicherordner zu ändern, die dem Migrationspunkt zugeordnet sind, wie lange gewartet werden soll, bis der Migrationspunkt Clientdaten löscht, ob ein Fallbackquellspeicherort für Inhalte zugelassen werden soll und ob der reine Wiederherstellungsmodus aktiviert werden soll.

Sie können angeben, welcher Migrationspunkt geändert werden soll, indem Sie den Namen des Standortsystemsservers und den Standortcode verwenden oder das Cmdlet Get-CMStateMigrationPoint verwenden.

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: Ändern eines Zustandsmigrationspunkts

PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours

In diesem Beispiel wird ein Migrationspunkt namens MigrationServer.TSQA.Contoso.com für den Standort mit dem Code CM4 geändert. Im Beispiel wird der Migrationspunkt so geändert, dass er einen Fallbackquellspeicherort für Inhalte zulässt, und es wird geändert, wie lange nach dem Datendownload Daten gelöscht werden.

Der erste Befehl ruft mit dem Cmdlet Get-CMStateMigrationPoint einen Migrationspunkt für den angegebenen Standortcode und servernamen ab und speichert ihn in der variablen $StateMigrationPoint.

Der zweite Befehl ändert das in der $StateMigrationPoint Variable gespeicherte Eingabeobjekt. Der Befehl legt den Parameter AllowFallbackSourceLocationForContent auf $True fest und ändert die Zeit für das Löschen nach 12 Stunden.

Beispiel 2: Ändern von Speicherordnern und Begrenzungsgruppen für einen Zustandsmigrationspunkt

PS XYZ:\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName "C:\"
PS XYZ:\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName "D:\"
PS XYZ:\> Set-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com" -AddBoundaryGroupName "BG07" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName "BG22" -RemoveStorageFolder $Storage01

In diesem Beispiel werden die Einstellungen für einen Zustandsmigrationspunkt mit dem Namen MigrationServer.TSQA.Contoso.com für den Standort mit dem Standortcode CM4 geändert. Das Beispiel ersetzt eine andere Begrenzungsgruppe und einen anderen Speicherordner und ändert andere Einstellungen.

Der erste Befehl erstellt mithilfe des Cmdlets New-CMStoragefolder ein Speicherordnerobjekt und speichert es in der Variablen $Storage 01. Weitere Informationen finden Sie in der Dokumentation zu diesem Cmdlet.

Der zweite Befehl erstellt mithilfe des Cmdlets New-CMStoragefolder ein Speicherordnerobjekt und speichert es in der Variablen $Storage 02.

Der dritte Befehl entfernt den in der Variablen $Storage 01 gespeicherten Speicherordner aus dem Migrationspunkt und fügt im selben Befehl den in der Variablen $Storage 02 gespeicherten Speicherordner dem Migrationspunkt hinzu. Ebenso entfernt der Befehl die Begrenzungsgruppe mit dem Namen BG22 und fügt die Begrenzungsgruppe mit dem Namen BG07 hinzu. Der Befehl gibt außerdem den Wert $False für den Parameter AllowFallbackSourceLocationForContent und den Wert $True für den EnableRestoreOnlyMode-Parameter an. Der Befehl verwendet den Parameter DeleteImmediately . Daher löscht der Migrationspunkt Clientinformationen unmittelbar nach dem Download.

Parameter

-AddBoundaryGroupName

Gibt ein Array von Begrenzungsgruppennamen an. Das Cmdlet fügt diese Begrenzungsgruppen dem Zustandsmigrationspunkt hinzu. Während der Migration verwenden Clients in einer Begrenzungsgruppe diesen Standort als Quellspeicherort für Inhalte.

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

-AddStorageFolder

Gibt ein Array von Speicherordnern als Speicherverzeichnisdatenobjekte an. Das Cmdlet fügt diese Ordner dem Zustandsmigrationspunkt hinzu. Verwenden Sie zum Abrufen eines Speicherverzeichnisdatenobjekts das Cmdlet New-CMStoragefolder .

Ein Zustandsmigrationspunkt speichert Benutzerzustandsdaten, wenn er einen Computer zu einem neuen Betriebssystem migriert.

Typ:StorageDirectoryData[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowFallbackSourceLocationForContent

Gibt an, ob ein Fallbackquellspeicherort verfügbar ist.

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

-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

-DeleteImmediately

Gibt an, dass das Löschen von Clientdaten unmittelbar nach dem Herunterladen der Daten durch den Zielcomputer erfolgt. Wenn Sie den Wert $False auswählen, geben Sie mit den Parametern TimeDeleteAfter und TimeUnit an, wie lange gewartet werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
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

-EnableRestoreOnlyMode

Gibt an, ob der reine Wiederherstellungsmodus aktiviert werden soll. Im Wiederherstellungsmodus lehnt Configuration Manager neue Anforderungen zum Speichern von Clientdaten ab.

Typ:Boolean
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 zum Abrufen eines Zustandsmigrationspunktobjekts das Cmdlet Get-CMStateMigrationPoint .

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-RemoveBoundaryGroupName

Gibt ein Array von Begrenzungsgruppennamen an. Das Cmdlet entfernt diese Begrenzungsgruppen aus dem Zustandsmigrationspunkt. Während der Migration verwenden Clients in einer Begrenzungsgruppe diesen Standort als Quellspeicherort für Inhalte.

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

-RemoveStorageFolder

Gibt ein Array von Speicherordnern als Speicherverzeichnisdatenobjekte an. Das Cmdlet entfernt diese Ordner aus dem Zustandsmigrationspunkt. Ein Zustandsmigrationspunkt speichert Benutzerzustandsdaten, wenn er einen Computer zu einem neuen Betriebssystem migriert.

Typ:StorageDirectoryData[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteCode

Gibt den 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

-TimeDeleteAfter

Gibt die Zeitspanne an, die gewartet werden soll, nachdem der Zielcomputer Daten zum Löschen dieser Daten heruntergeladen hat. Geben Sie eine Zeiteinheit mit dem TimeUnit-Parameter an. Um Daten sofort zu löschen, geben Sie den Wert $True für den Parameter DeleteImmediately an .

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

-TimeUnit

Gibt eine Zeiteinheit für den im TimeDeleteAfter-Parameter angegebenen Wert an. Die zulässigen Werte für diesen Parameter sind: Tage und Stunden.

Typ:IntervalType
Zulässige Werte:Hours, Days
Position:Named
Standardwert:None
Erforderlich:False
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

IResultObject