Set-CMStateMigrationPoint
Modifica la configuración de un punto de migración de estado en 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>]
Description
El cmdlet Set-CMStateMigrationPoint modifica la configuración de un punto de migración de estado en Configuration Manager. Un punto de migración de estado es un rol de sistema de sitio que administra la transferencia de datos desde equipos cliente durante un proceso de instalación del sistema operativo. Use este cmdlet para modificar los grupos de límites y las carpetas de almacenamiento asociadas con el punto de migración, cuánto tiempo se debe esperar antes de que el punto de migración elimine los datos del cliente, si se va a permitir una ubicación de origen de reserva para el contenido y si se habilita el modo de restauración solo.
Puede especificar qué punto de migración modificar mediante el nombre del servidor del sistema de sitio y el código de sitio, o usar el cmdlet Get-CMStateMigrationPoint.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Modificar un punto de migración de estado
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours
En este ejemplo se modifica un punto de migración denominado MigrationServer.TSQA.Contoso.com para el sitio que tiene el código CM4. En el ejemplo se cambia el punto de migración para permitir una ubicación de origen de reserva para el contenido y se modifica cuánto tiempo después de la descarga de datos se eliminan los datos.
El primer comando usa el cmdlet Get-CMStateMigrationPoint para obtener un punto de migración para el código de sitio y el nombre del servidor especificados, y lo almacena en la variable $StateMigrationPoint.
El segundo comando modifica el objeto de entrada almacenado en la variable $StateMigrationPoint entrada. El comando establece el parámetro AllowFallbackSourceLocationForContent en $True y modifica el tiempo para eliminar después de 12 horas.
Ejemplo 2: Modificar carpetas de almacenamiento y grupos de límites para un punto de migración de estado
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
En este ejemplo se modifica la configuración de un punto de migración de estado denominado MigrationServer.TSQA.Contoso.com para el sitio que tiene el código de sitio CM4. En el ejemplo se sustituye un grupo de límites diferente y una carpeta de almacenamiento diferente y se modifican otras opciones de configuración.
El primer comando usa el cmdlet New-CMStoragefolder para crear un objeto de carpeta de almacenamiento y lo almacena en la variable $Storage 01. Consulte la documentación de ese cmdlet para obtener más información.
El segundo comando usa el cmdlet New-CMStoragefolder para crear un objeto de carpeta de almacenamiento y lo almacena en la variable $Storage 02.
El tercer comando quita la carpeta de almacenamiento almacenada en la variable $Storage 01 del punto de migración y, en el mismo comando, agrega la carpeta de almacenamiento almacenada en la variable $Storage 02 al punto de migración. Del mismo modo, el comando quita el grupo de límites denominado BG22 y agrega el grupo de límites denominado BG07. El comando también especifica un valor de $False para el parámetro AllowFallbackSourceLocationForContent y un valor de $True para el parámetro EnableRestoreOnlyMode. El comando usa el parámetro DeleteImmediately; por lo tanto, el punto de migración elimina la información del cliente inmediatamente después de la descarga.
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddBoundaryGroupName
Especifica una matriz de nombres de grupo de límites. El cmdlet agrega estos grupos de límites al punto de migración de estado. Durante la migración, los clientes de un grupo de límites usan este sitio como ubicación de origen para el contenido.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddStorageFolder
Especifica una matriz de carpetas de almacenamiento, como objetos de datos de directorio de almacenamiento. El cmdlet agrega estas carpetas al punto de migración de estado. Para obtener un objeto de datos de directorio de almacenamiento, use el cmdlet New-CMStoragefolder.
Un punto de migración de estado almacena datos de estado de usuario cuando migra un equipo a un nuevo sistema operativo.
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallbackSourceLocationForContent
Indica si hay disponible una ubicación de origen de reserva.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeleteImmediately
Indica que la eliminación de datos de cliente se produce inmediatamente después de que el equipo de destino descargue los datos. Si selecciona un valor de $False, especifique cuánto tiempo se debe esperar mediante los parámetros TimeDeleteAfter y TimeUnit.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableRestoreOnlyMode
Indica si se habilita solo el modo de restauración. En el modo de solo restauración, Configuration Manager rechaza las nuevas solicitudes para almacenar datos de cliente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica un objeto de punto de migración de estado. Para obtener un objeto de punto de migración de estado, use el cmdlet Get-CMStateMigrationPoint.
Type: | IResultObject |
Aliases: | StateMigrationPoint |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, es posible que este cmdlet no genere ningún resultado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveBoundaryGroupName
Especifica una matriz de nombres de grupo de límites. El cmdlet quita estos grupos de límites del punto de migración de estado. Durante la migración, los clientes de un grupo de límites usan este sitio como ubicación de origen para el contenido.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveStorageFolder
Especifica una matriz de carpetas de almacenamiento, como objetos de datos de directorio de almacenamiento. El cmdlet quita estas carpetas del punto de migración de estado. Un punto de migración de estado almacena datos de estado de usuario cuando migra un equipo a un nuevo sistema operativo.
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Especifica el código de sitio de un sitio de Configuration Manager.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteSystemServerName
Especifica el nombre de host de un punto de migración de estado.
Type: | String |
Aliases: | Name, ServerName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeDeleteAfter
Especifica la cantidad de tiempo que se debe esperar después de que el equipo de destino descargue los datos para eliminar los datos. Especifique una unidad de tiempo mediante el parámetro TimeUnit. Para eliminar los datos inmediatamente, especifique un valor de $True para el parámetro DeleteImmediately.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeUnit
Especifica una unidad de tiempo para el valor especificado en el parámetro TimeDeleteAfter. Los valores aceptables para este parámetro son: Días y Horas.
Type: | IntervalType |
Accepted values: | Hours, Days |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject