Partilhar via


Set-CMStateMigrationPoint

SYNOPSIS

Modifica as definições para um ponto de migração do estado no Gestor de Configuração.

SYNTAX

SetByValue (Padrão)

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

SetByName

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 do estado no Gestor de Configuração. Um ponto de migração do Estado é uma função do sistema de site que gere a transferência de dados de computadores clientes 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 permita uma localização de fonte de retorno para o conteúdo, e se permite restaurar apenas o modo.

Pode especificar qual o ponto de migração a modificar utilizando o nome do servidor do sistema de site e o código do site, ou utilizar o cmdlet Get-CMStateMigrationPoint.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Modificar um ponto de migração do 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

Este exemplo modifica um ponto de migração denominado 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 fonte de retorno para o conteúdo, e modifica quanto tempo após o download de dados para apagar dados.

O primeiro comando utiliza o cmdlet Get-CMStateMigrationPoint para obter um ponto de migração para o código de 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 para apagar após 12 horas.

Exemplo 2: Modificar as pastas de armazenamento e os grupos de fronteira para um ponto de migração do 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

Este exemplo modifica as configurações para um ponto de migração do Estado denominado MigrationServer.TSQA.Contoso.com para o site que tem o código de site CM4. O exemplo substitui um grupo de fronteira diferente e uma pasta de armazenamento diferente, e modifica outras configuraçõ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 para o 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 fronteira chamado BG22 e adiciona o grupo de fronteira chamado 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; portanto, o ponto de migração elimina a informação do cliente imediatamente após o download.

PARAMETERS

-AddBoundaryGroupName

Especifica uma série de nomes de grupos de fronteira. O cmdlet adiciona estes grupos de fronteira ao ponto de migração do estado. Durante a migração, os clientes de um grupo de fronteiras usam este site como localização de origem para o conteúdo.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AddStorageFolder

Especifica uma variedade de pastas de armazenamento, como objetos de dados de diretório de armazenamento. O cmdlet adiciona estas pastas ao ponto de migração do estado. Para obter um objeto de dados de diretório de armazenamento, utilize o cmdlet new-CMStoragefolder.

Um ponto de migração estatal armazena dados do estado do utilizador quando migra um computador para um novo sistema operativo.

Type: StorageDirectoryData[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowFallbackSourceLocationForContent

Indica se está disponível uma localização de fonte de retorno.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ExcluirImmediatemente

Indica que a eliminação dos dados do cliente ocorre imediatamente após o computador-alvo transferir esses dados. Se selecionar um valor de $False, especifique quanto tempo esperar utilizando os parâmetros TimeDeleteAfter e TimeUnit.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableRestoreOnlyMode

Indica se ativa apenas o modo de restauro. No modo de restauração apenas, o Gestor de Configuração recusa novos pedidos para armazenar dados do cliente.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Especifica um objeto de ponto de migração do estado. Para obter um objeto de ponto de migração do estado, utilize o cmdlet Get-CMStateMigrationPoint.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: StateMigrationPoint

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

- PassThru

Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemoveBoundaryGroupName

Especifica uma série de nomes de grupos de fronteira. O cmdlet remove estes grupos de fronteira do ponto de migração do estado. Durante a migração, os clientes de um grupo de fronteiras usam este site como localização de origem para o conteúdo.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemoveStorageFolder

Especifica uma variedade de pastas de armazenamento, como objetos de dados de diretório de armazenamento. O cmdlet remove estas pastas do ponto de migração do estado. Um ponto de migração estatal armazena dados do estado do utilizador quando migra um computador para um novo sistema operativo.

Type: StorageDirectoryData[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- SiteCode

Especifica o código do site para um site do Gestor de Configurações.

Type: String
Parameter Sets: SetByName
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SiteSystemServerName

Especifica o nome hospedeiro para um ponto de migração do estado.

Type: String
Parameter Sets: SetByName
Aliases: Name, ServerName

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TimeDeleteAfter

Especifica a quantidade de tempo para esperar depois de o computador-alvo transferir dados para eliminar esses dados. Especifique uma unidade de tempo utilizando o parâmetro TimeUnit. Para eliminar imediatamente os dados, especifique um valor de $True para o parâmetro DeleteImmediately.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: IntervalType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_SCI_SysResUse

NOTAS

Ponto de Imigração de Estado-CM

Get-CMStateMigrationPoint

Remover-CMStateMigrationPoint

New-CMStoragefolder