Set-CMStateMigrationPoint
Ändert Die Einstellungen für einen Statusmigrationspunkt 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
Mit dem Cmdlet "Set-CMStateMigrationPoint" werden die Einstellungen für einen Statusmigrationspunkt in Configuration Manager geändert. Ein Statusmigrationspunkt ist eine Standortsystemrolle, die die Datenübertragung von Clientcomputern während eines Installationsvorgangs des Betriebssystems verwaltet. Verwenden Sie dieses Cmdlet, um die Begrenzungsgruppen und Speicherordner zu ändern, die dem Migrationspunkt zugeordnet sind, wie lange gewartet werden muss, bevor der Migrationspunkt Clientdaten löscht, ob ein Fallbackquellspeicherort für Inhalte zulässig ist und ob der Modus "Nur Wiederherstellen" aktiviert werden soll.
Sie können angeben, welcher Migrationspunkt geändert werden soll, indem Sie den Servernamen des Standortsystems und den Websitecode verwenden oder das Cmdlet "Get-CMStateMigrationPoint" verwenden.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Ändern eines Statusmigrationspunkts
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit HoursIn diesem Beispiel wird ein Migrationspunkt namens MigrationServer.TSQA.Contoso.com für die Website mit dem Code CM4 geändert. Im Beispiel wird der Migrationspunkt so geändert, dass ein Fallbackquellspeicherort für Inhalte zulässig ist, und es wird geändert, wie lange nach dem Datendownload Daten gelöscht werden sollen.
Der erste Befehl verwendet das Cmdlet "Get-CMStateMigrationPoint", um einen Migrationspunkt für den angegebenen Websitecode und Servernamen abzurufen, und speichert ihn in der variablen $StateMigrationPoint.
Mit dem zweiten Befehl wird das in der $StateMigrationPoint-Variable gespeicherte Eingabeobjekt geändert. Der Befehl legt den Parameter AllowFallbackSourceLocationForContent auf $True fest und ändert die Zu löschende Zeit nach 12 Stunden.
Beispiel 2: Ändern von Speicherordnern und Begrenzungsgruppen für einen Statusmigrationspunkt
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 $Storage01In diesem Beispiel werden die Einstellungen für einen Statusmigrationspunkt namens MigrationServer.TSQA.Contoso.com für die Website mit dem Websitecode CM4 geändert. Das Beispiel ersetzt eine andere Begrenzungsgruppe und einen anderen Speicherordner und ändert andere Einstellungen.
Der erste Befehl verwendet das Cmdlet "New-CMStoragefolder", um ein Speicherordnerobjekt zu erstellen und es in der Variablen $Storage 01 zu speichern. Weitere Informationen finden Sie in der Dokumentation zu diesem Cmdlet.
Der zweite Befehl verwendet das Cmdlet "New-CMStoragefolder", um ein Speicherordnerobjekt zu erstellen und es in der Variablen $Storage 02 zu speichern.
Der dritte Befehl entfernt den in der Variablen $Storage 01 gespeicherten Speicherordner vom Migrationspunkt und fügt im gleichen Befehl den in der Variablen $Storage 02 gespeicherten Speicherordner zum Migrationspunkt hinzu. Ebenso entfernt der Befehl die Begrenzungsgruppe BG22 und fügt die Begrenzungsgruppe BG07 hinzu. Der Befehl gibt außerdem den Wert $False für den Parameter AllowFallbackSourceLocationForContent und den Wert $True für den Parameter EnableRestoreOnlyMode 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 Statusmigrationspunkt hinzu. Während der Migration verwenden Clients in einer Begrenzungsgruppe diese Website als Quellspeicherort für Inhalte.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddStorageFolder
Gibt ein Array von Speicherordnern als Speicherverzeichnisdatenobjekte an. Das Cmdlet fügt diese Ordner dem Statusmigrationspunkt hinzu. Verwenden Sie das Cmdlet "New-CMStoragefolder", um ein Speicherverzeichnisdatenobjekt abzurufen.
Ein Statusmigrationspunkt speichert Benutzerstatusdaten, wenn ein Computer zu einem neuen Betriebssystem migriert wird.
| Type: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowFallbackSourceLocationForContent
Gibt an, ob ein Fallbackquellspeicherort verfügbar ist.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeleteImmediately
Gibt an, dass das Löschen von Clientdaten unmittelbar erfolgt, nachdem der Zielcomputer diese Daten heruntergeladen hat. Wenn Sie den Wert $False auswählen, geben Sie mithilfe der Parameter TimeDeleteAfter und TimeUnit an, wie lange gewartet werden soll.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableRestoreOnlyMode
Gibt an, ob der Modus "Nur Wiederherstellen" aktiviert werden soll. Im Modus "Nur Wiederherstellen" lehnt Configuration Manager neue Anforderungen zum Speichern von Clientdaten ab.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt ein Statusmigrationspunktobjekt an. Verwenden Sie das Cmdlet "Get-CMStateMigrationPoint", um ein Statusmigrationspunktobjekt abzurufen.
| Type: | IResultObject |
| Aliases: | StateMigrationPoint |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveBoundaryGroupName
Gibt ein Array von Begrenzungsgruppennamen an. Das Cmdlet entfernt diese Begrenzungsgruppen aus dem Statusmigrationspunkt. Während der Migration verwenden Clients in einer Begrenzungsgruppe diese Website als Quellspeicherort für Inhalte.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveStorageFolder
Gibt ein Array von Speicherordnern als Speicherverzeichnisdatenobjekte an. Das Cmdlet entfernt diese Ordner aus dem Statusmigrationspunkt. Ein Statusmigrationspunkt speichert Benutzerstatusdaten, wenn ein Computer zu einem neuen Betriebssystem migriert wird.
| Type: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SiteCode
Gibt den Standortcode für eine Configuration Manager-Website an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SiteSystemServerName
Gibt den Hostnamen für einen Statusmigrationspunkt an.
| Type: | String |
| Aliases: | Name, ServerName |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeDeleteAfter
Gibt an, wie lange gewartet werden soll, nachdem der Zielcomputer Daten heruntergeladen hat, um diese Daten zu löschen. Geben Sie mithilfe des TimeUnit-Parameters eine Zeiteinheit an. Um Daten sofort zu löschen, geben Sie den Wert $True für den Parameter DeleteImmediately an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeUnit
Gibt eine Zeiteinheit für den im Parameter TimeDeleteAfter angegebenen Wert an. Die zulässigen Werte für diesen Parameter sind: Tage und Stunden.
| Type: | IntervalType |
| Accepted values: | Hours, Days |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject