Set-CMStateMigrationPoint
Modifica as definições de um ponto de migração de estado no Configuration Manager.
Sintaxe
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
O cmdlet Set-CMStateMigrationPoint modifica as definições para um ponto de migração de estado no Configuration Manager. Um ponto de migração de estado é uma função do sistema de sites que gere a transferência de dados de computadores cliente durante um processo de instalação do sistema operativo. Utilize este cmdlet para modificar os grupos de limites e as pastas de armazenamento associadas ao ponto de migração, quanto tempo esperar até que o ponto de migração elimine os dados do cliente, se pretende permitir uma localização de origem de contingência para o conteúdo e se pretende ativar o modo apenas de restauro.
Pode especificar o ponto de migração a modificar com o nome do servidor do sistema de sites e o código do site ou utilizar o cmdlet Get-CMStateMigrationPoint .
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Modificar um ponto de migração 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 HoursEste exemplo modifica um ponto de migração com o nome MigrationServer.TSQA.Contoso.com para o site que tem o código CM4. O exemplo altera o ponto de migração para permitir uma localização de origem de contingência para o conteúdo e modifica quanto tempo após a transferência de dados para eliminar dados.
O primeiro comando utiliza o cmdlet Get-CMStateMigrationPoint para obter um ponto de migração para o código do site especificado e o nome do servidor e armazena-o na variável $StateMigrationPoint.
O segundo comando modifica o objeto de entrada armazenado na variável $StateMigrationPoint. O comando define o parâmetro AllowFallbackSourceLocationForContent para $True e modifica o tempo a eliminar após 12 horas.
Exemplo 2: Modificar pastas de armazenamento e grupos de limites para um ponto de migração 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 $Storage01Este exemplo modifica as definições de um ponto de migração de estado com o nome MigrationServer.TSQA.Contoso.com para o site que tem o código do site CM4. O exemplo substitui um grupo de limites diferente e uma pasta de armazenamento diferente e modifica outras definições.
O primeiro comando utiliza o cmdlet New-CMStoragefolder para criar um objeto de pasta de armazenamento e armazena-o na variável $Storage 01. Consulte a documentação desse cmdlet para obter mais informações.
O segundo comando utiliza o cmdlet New-CMStoragefolder para criar um objeto de pasta de armazenamento e armazena-o na variável $Storage 02.
O terceiro comando remove a pasta de armazenamento armazenada na variável $Storage 01 do ponto de migração e, no mesmo comando, adiciona a pasta de armazenamento armazenada na variável $Storage 02 ao ponto de migração. Da mesma forma, o comando remove o grupo de limites denominado BG22 e adiciona o grupo de limites denominado BG07. O comando também especifica um valor de $False para o parâmetro AllowFallbackSourceLocationForContent e um valor de $True para o parâmetro EnableRestoreOnlyMode . O comando utiliza o parâmetro DeleteImmediately ; por conseguinte, o ponto de migração elimina as informações do cliente imediatamente após a transferência.
Parâmetros
-AddBoundaryGroupName
Especifica uma matriz de nomes de grupos de limites. O cmdlet adiciona estes grupos de limites ao ponto de migração de estado. Durante a migração, os clientes num grupo de limites utilizam este site como uma localização de origem para o conteúdo.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AddStorageFolder
Especifica uma matriz de pastas de armazenamento, como objetos de dados de diretório de armazenamento. O cmdlet adiciona estas pastas ao ponto de migração de estado. Para obter um objeto de dados de diretório de armazenamento, utilize o cmdlet New-CMStoragefolder .
Um ponto de migração de estado armazena dados de estado do utilizador quando migra um computador para um novo sistema operativo.
| Tipo: | StorageDirectoryData[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllowFallbackSourceLocationForContent
Indica se está disponível uma localização de origem de contingência.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DeleteImmediately
Indica que a eliminação de dados de cliente ocorre imediatamente após o computador de destino transferir esses dados. Se selecionar um valor de $False, especifique quanto tempo esperar com os parâmetros TimeDeleteAfter e TimeUnit .
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableRestoreOnlyMode
Indica se pretende ativar o modo apenas de restauro. No modo apenas de restauro, o Configuration Manager recusa novos pedidos para armazenar dados de cliente.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Especifica um objeto de ponto de migração de estado. Para obter um objeto de ponto de migração de estado, utilize o cmdlet Get-CMStateMigrationPoint .
| Tipo: | IResultObject |
| Aliases: | StateMigrationPoint |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PassThru
Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RemoveBoundaryGroupName
Especifica uma matriz de nomes de grupos de limites. O cmdlet remove estes grupos de limites do ponto de migração de estado. Durante a migração, os clientes num grupo de limites utilizam este site como uma localização de origem para o conteúdo.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RemoveStorageFolder
Especifica uma matriz de pastas de armazenamento, como objetos de dados de diretório de armazenamento. O cmdlet remove estas pastas do ponto de migração de estado. Um ponto de migração de estado armazena dados de estado do utilizador quando migra um computador para um novo sistema operativo.
| Tipo: | StorageDirectoryData[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SiteCode
Especifica o código do site para um site do Configuration Manager.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SiteSystemServerName
Especifica o nome do anfitrião para um ponto de migração de estado.
| Tipo: | String |
| Aliases: | Name, ServerName |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-TimeDeleteAfter
Especifica a quantidade de tempo a aguardar depois de o computador de destino transferir os dados para eliminar esses dados. Especifique uma unidade de tempo com o parâmetro TimeUnit . Para eliminar dados imediatamente, especifique um valor de $True para o parâmetro DeleteImmediately .
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-TimeUnit
Especifica uma unidade de tempo para o valor especificado no parâmetro TimeDeleteAfter . Os valores aceitáveis para este parâmetro são: Dias e Horas.
| Tipo: | IntervalType |
| Valores aceitos: | Hours, Days |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject