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. Utilizzare questo cmdlet per modificare i gruppi di limiti e le cartelle di archiviazione associate al punto di migrazione, il tempo di attesa prima che il punto di migrazione elimini i dati del client, se consentire un percorso di origine di fallback per il contenuto e se abilitare la modalità solo ripristino.
È possibile specificare il punto di migrazione da modificare utilizzando il nome del server del sistema del sito e il codice del sito oppure utilizzare il cmdlet Get-CMStateMigrationPoint.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>
. Per ulteriori 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 codice CM4. Nell'esempio viene modificato il punto di migrazione per consentire un percorso di origine di fallback per il contenuto e viene modificato il tempo dopo il download dei dati per eliminare i dati.
Il primo comando utilizza 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 $StateMigrationPoint variabile. Il comando imposta il parametro AllowFallbackSourceLocationForContent su $True e modifica il tempo da eliminare dopo 12 ore.
Esempio 2: Modificare le cartelle di archiviazione e i 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 di sito CM4. L'esempio sostituisce un gruppo di limiti diverso e una cartella di archiviazione diversa e modifica altre impostazioni.
Il primo comando utilizza il cmdlet New-CMStoragefolder per creare un oggetto cartella di archiviazione e lo archivia nella variabile $Storage 01. Per ulteriori informazioni, vedere la documentazione relativa a tale cmdlet.
Il secondo comando utilizza 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 inoltre un valore di $False per il parametro AllowFallbackSourceLocationForContent e un valore di $True per il parametro EnableRestoreOnlyMode. Il comando utilizza il parametro DeleteImmediately. Pertanto, il punto di migrazione elimina le informazioni sul client subito 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 di un gruppo di limiti utilizzano questo sito come percorso di origine per il contenuto.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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, utilizzare il cmdlet New-CMStoragefolder.
Un punto di migrazione dello stato archivia i dati sullo stato utente durante la migrazione di un computer a un nuovo sistema operativo.
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallbackSourceLocationForContent
Indica se è disponibile un percorso di origine di fallback.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeleteImmediately
Indica che l'eliminazione dei dati del client avviene subito dopo il download dei dati da parte del computer di destinazione. Se si seleziona un valore di $False, specificare il tempo di attesa utilizzando i parametri TimeDeleteAfter e TimeUnit.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableRestoreOnlyMode
Indica se abilitare la modalità solo ripristino. In modalità solo ripristino, Configuration Manager rifiuta le nuove richieste di archiviazione dei dati del client.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica un oggetto punto di migrazione dello stato. Per ottenere un oggetto punto di migrazione dello stato, utilizzare il cmdlet Get-CMStateMigrationPoint.
Type: | IResultObject |
Aliases: | StateMigrationPoint |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 di un gruppo di limiti utilizzano questo sito come percorso di origine per il contenuto.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 durante la migrazione di un computer a un nuovo sistema operativo.
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Specifica il codice del sito per un sito di Configuration Manager.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteSystemServerName
Specifica il nome host per un punto di migrazione dello stato.
Type: | String |
Aliases: | Name, ServerName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeDeleteAfter
Specifica il tempo di attesa dopo che il computer di destinazione scarica i dati per eliminarli. Specificare un'unità di tempo utilizzando il parametro TimeUnit. Per eliminare immediatamente i dati, specificare un valore di $True per il parametro DeleteImmediately.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeUnit
Specifica un'unità di tempo per il valore specificato nel parametro TimeDeleteAfter. I valori accettabili per questo parametro sono: Giorni e Ore.
Type: | IntervalType |
Accepted values: | Hours, Days |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject