Set-CMStateMigrationPoint

  • Riferimento
Modulo:
ConfigurationManager

Modifica le impostazioni per un punto di migrazione dello stato in Configuration Manager.

Sintassi

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

Descrizione

Il cmdlet Set-CMStateMigrationPoint modifica le impostazioni per un punto di migrazione dello stato in Configuration Manager. Un punto di migrazione dello stato è un ruolo del sistema del sito che gestisce il trasferimento dei dati dai computer client durante un processo di installazione del sistema operativo. Usare questo cmdlet per modificare i gruppi di limiti e le cartelle di archiviazione associati al punto di migrazione, il tempo di attesa prima che il punto di migrazione elimini i dati client, se consentire un percorso di origine di fallback per il contenuto e se abilitare la modalità solo di ripristino.

È possibile specificare il punto di migrazione da modificare usando il nome del server del sistema del sito e il codice del sito oppure usare il cmdlet Get-CMStateMigrationPoint .

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare un punto di migrazione dello stato

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 questo esempio viene modificato un punto di migrazione denominato MigrationServer.TSQA.Contoso.com per il sito con il codice CM4. Nell'esempio viene modificato il punto di migrazione in modo da consentire un percorso di origine di fallback per il contenuto e viene modificato il tempo trascorso dal download dei dati per eliminare i dati.

Il primo comando usa il cmdlet Get-CMStateMigrationPoint per ottenere un punto di migrazione per il codice del sito e il nome del server specificati e lo archivia nella variabile $StateMigrationPoint.

Il secondo comando modifica l'oggetto di input archiviato nella variabile $StateMigrationPoint. Il comando imposta il parametro AllowFallbackSourceLocationForContent su $True e modifica l'ora di eliminazione dopo 12 ore.

Esempio 2: Modificare cartelle di archiviazione e gruppi di limiti per un punto di migrazione dello stato

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 questo esempio vengono modificate le impostazioni per un punto di migrazione dello stato denominato MigrationServer.TSQA.Contoso.com per il sito con codice del sito CM4. L'esempio sostituisce un gruppo di limiti diverso e una cartella di archiviazione diversa e modifica altre impostazioni.

Il primo comando usa il cmdlet New-CMStoragefolder per creare un oggetto cartella di archiviazione e lo archivia nella variabile $Storage 01. Per altre informazioni, vedere la documentazione relativa al cmdlet.

Il secondo comando usa il cmdlet New-CMStoragefolder per creare un oggetto cartella di archiviazione e lo archivia nella variabile $Storage 02.

Il terzo comando rimuove la cartella di archiviazione archiviata nella variabile $Storage 01 dal punto di migrazione e, nello stesso comando, aggiunge la cartella di archiviazione archiviata nella variabile $Storage 02 al punto di migrazione. Analogamente, il comando rimuove il gruppo di limiti denominato BG22 e aggiunge il gruppo di limiti denominato BG07. Il comando specifica anche un valore di $False per il parametro AllowFallbackSourceLocationForContent e un valore di $True per il parametro EnableRestoreOnlyMode . Il comando usa il parametro DeleteImmediately ; Pertanto, il punto di migrazione elimina le informazioni client immediatamente dopo il download.

Parametri

-AddBoundaryGroupName

Specifica una matrice di nomi di gruppi di limiti. Il cmdlet aggiunge questi gruppi di limiti al punto di migrazione dello stato. Durante la migrazione, i client in un gruppo di limiti usano questo sito come percorso di origine per il contenuto.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddStorageFolder

Specifica una matrice di cartelle di archiviazione, come oggetti dati della directory di archiviazione. Il cmdlet aggiunge queste cartelle al punto di migrazione dello stato. Per ottenere un oggetto dati della directory di archiviazione, usare il cmdlet New-CMStoragefolder .

Un punto di migrazione dello stato archivia i dati sullo stato utente quando esegue la migrazione di un computer a un nuovo sistema operativo.

Tipo:StorageDirectoryData[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowFallbackSourceLocationForContent

Indica se è disponibile un percorso di origine di fallback.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeleteImmediately

Indica che l'eliminazione dei dati client viene eseguita immediatamente dopo il download dei dati da parte del computer di destinazione. Se si seleziona un valore di $False, specificare per quanto tempo attendere usando i parametri TimeDeleteAfter e TimeUnit .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableRestoreOnlyMode

Indica se abilitare solo la modalità di ripristino. In modalità solo ripristino, Configuration Manager rifiuta le nuove richieste di archiviazione dei dati client.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto punto di migrazione dello stato. Per ottenere un oggetto punto di migrazione dello stato, usare il cmdlet Get-CMStateMigrationPoint .

Tipo:IResultObject
Alias:StateMigrationPoint
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveBoundaryGroupName

Specifica una matrice di nomi di gruppi di limiti. Il cmdlet rimuove questi gruppi di limiti dal punto di migrazione dello stato. Durante la migrazione, i client in un gruppo di limiti usano questo sito come percorso di origine per il contenuto.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveStorageFolder

Specifica una matrice di cartelle di archiviazione, come oggetti dati della directory di archiviazione. Il cmdlet rimuove queste cartelle dal punto di migrazione dello stato. Un punto di migrazione dello stato archivia i dati sullo stato utente quando esegue la migrazione di un computer a un nuovo sistema operativo.

Tipo:StorageDirectoryData[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SiteCode

Specifica il codice del sito per un sito di Configuration Manager.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SiteSystemServerName

Specifica il nome host per un punto di migrazione dello stato.

Tipo:String
Alias:Name, ServerName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeDeleteAfter

Specifica la quantità di tempo di attesa dopo che il computer di destinazione scarica i dati per eliminare tali dati. Specificare un'unità di tempo usando il parametro TimeUnit . Per eliminare immediatamente i dati, specificare un valore di $True per il parametro DeleteImmediately .

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeUnit

Specifica un'unità di tempo per il valore specificato nel parametro TimeDeleteAfter . I valori accettabili per questo parametro sono: Giorni e Ore.

Tipo:IntervalType
Valori accettati:Hours, Days
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject