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