Set-CMStateMigrationPoint
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 HoursIn 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 $Storage01In 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