Compartir a través de


Set-CMStateMigrationPoint

Modifica la configuración de un punto de migración de estado en Configuration Manager.

Sintaxis

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 al punto de migración, cuánto tiempo debe esperar antes de que el punto de migración elimine los datos de cliente, si se permite una ubicación de origen de reserva para el contenido y si se habilita el modo de solo restauración.

Puede especificar qué punto de migración modificar mediante el nombre del servidor del sistema de sitio y el código de sitio, o bien usar el cmdlet Get-CMStateMigrationPoint .

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Modificación de 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 el tiempo transcurrido después de la descarga de datos para eliminar 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. El comando establece el parámetro AllowFallbackSourceLocationForContent en $True y modifica el tiempo que se va a eliminar después de 12 horas.

Ejemplo 2: Modificación de 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

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

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AddStorageFolder

Especifica una matriz de carpetas de almacenamiento, como objetos de datos del 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 los datos de estado de usuario cuando migra un equipo a un nuevo sistema operativo.

Tipo:StorageDirectoryData[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowFallbackSourceLocationForContent

Indica si hay disponible una ubicación de origen de reserva.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeleteImmediately

Indica que la eliminación de datos de cliente se produce inmediatamente después de que el equipo de destino descargue esos datos. Si selecciona un valor de $False, especifique cuánto tiempo debe esperar mediante los parámetros TimeDeleteAfter y TimeUnit .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableRestoreOnlyMode

Indica si se va a habilitar el modo de solo restauración. En el modo de solo restauración, Configuration Manager rechaza nuevas solicitudes para almacenar datos de cliente.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:IResultObject
Alias:StateMigrationPoint
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveStorageFolder

Especifica una matriz de carpetas de almacenamiento, como objetos de datos del directorio de almacenamiento. El cmdlet quita estas carpetas del punto de migración de estado. Un punto de migración de estado almacena los datos de estado de usuario cuando migra un equipo a un nuevo sistema operativo.

Tipo:StorageDirectoryData[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SiteCode

Especifica el código de sitio de un sitio de Configuration Manager.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SiteSystemServerName

Especifica el nombre de host de un punto de migración de estado.

Tipo:String
Alias:Name, ServerName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimeDeleteAfter

Especifica la cantidad de tiempo que se debe esperar después de que el equipo de destino descargue los datos para eliminar esos datos. Especifique una unidad de tiempo mediante el parámetro TimeUnit . Para eliminar datos inmediatamente, especifique un valor de $True para el parámetro DeleteImmediately .

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:IntervalType
Valores aceptados:Hours, Days
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject