Set-CMStateMigrationPoint
Modifica as configurações de um ponto de migração de estado no 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
O cmdlet Set-CMStateMigrationPoint modifica as configurações de um ponto de migração de estado no Configuration Manager. Um ponto de migração de estado é uma função do sistema de site que gerencia a transferência de dados de computadores cliente durante um processo de instalação do sistema operacional. Use este cmdlet para modificar os grupos de limite e as pastas de armazenamento associadas ao ponto de migração, quanto tempo para aguardar até que o ponto de migração exclua os dados do cliente, se deve permitir um local de origem de fallback para o conteúdo e se deve habilitar a restauração somente o modo.
Você pode especificar qual ponto de migração modificar usando o nome do servidor do sistema de sites e o código do site ou usar o cmdlet Get-CMStateMigrationPoint.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
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 Hours
Este exemplo modifica um ponto de migração chamado MigrationServer.TSQA.Contoso.com para o site que tem o código CM4. O exemplo altera o ponto de migração para permitir um local de origem de fallback para conteúdo e modifica quanto tempo após o download de dados excluir dados.
O primeiro comando usa o cmdlet Get-CMStateMigrationPoint para obter um ponto de migração para o código de site especificado e o nome do servidor e o armazena na variável $StateMigrationPoint.
O segundo comando modifica o objeto de entrada armazenado na variável $StateMigrationPoint. O comando define o parâmetro AllowFallbackSourceLocationForContent como $True e modifica o tempo a ser excluído após 12 horas.
Exemplo 2: Modificar pastas de armazenamento e grupos de limite 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 $Storage01
Este exemplo modifica as configurações de um ponto de migração de estado chamado MigrationServer.TSQA.Contoso.com para o site que tem o código do site CM4. O exemplo substitui um grupo de limite diferente e uma pasta de armazenamento diferente e modifica outras configurações.
O primeiro comando usa o cmdlet New-CMStoragefolder para criar um objeto de pasta de armazenamento e o armazena na variável $Storage 01. Consulte a documentação desse cmdlet para obter mais informações.
O segundo comando usa o cmdlet New-CMStoragefolder para criar um objeto de pasta de armazenamento e o armazena 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 limite chamado BG22 e adiciona o grupo de limite 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 usa o parâmetro DeleteImmediately; portanto, o ponto de migração exclui as informações do cliente imediatamente após o download.
Parâmetros
-AddBoundaryGroupName
Especifica uma matriz de nomes de grupo de limite. O cmdlet adiciona esses grupos de limite ao ponto de migração de estado. Durante a migração, os clientes em um grupo de limite usam esse site como um local de origem para o conteúdo.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddStorageFolder
Especifica uma matriz de pastas de armazenamento, como objetos de dados de diretório de armazenamento. O cmdlet adiciona essas pastas ao ponto de migração de estado. Para obter um objeto de dados de diretório de armazenamento, use o cmdlet New-CMStoragefolder.
Um ponto de migração de estado armazena dados de estado do usuário quando migra um computador para um novo sistema operacional.
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallbackSourceLocationForContent
Indica se um local de origem de fallback está disponível.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeleteImmediately
Indica que a exclusão de dados do cliente ocorre imediatamente após o computador de destino baixar esses dados. Se você selecionar um valor de $False, especifique quanto tempo esperar usando os parâmetros TimeDeleteAfter e TimeUnit.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableRestoreOnlyMode
Indica se deve habilitar somente o modo de restauração. No modo somente restauração, o Configuration Manager recusa novas solicitações para armazenar dados do cliente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica um objeto de ponto de migração de estado. Para obter um objeto de ponto de migração de estado, use o cmdlet Get-CMStateMigrationPoint.
Type: | IResultObject |
Aliases: | StateMigrationPoint |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveBoundaryGroupName
Especifica uma matriz de nomes de grupo de limite. O cmdlet remove esses grupos de limite do ponto de migração de estado. Durante a migração, os clientes em um grupo de limite usam esse site como um local de origem para o conteúdo.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveStorageFolder
Especifica uma matriz de pastas de armazenamento, como objetos de dados de diretório de armazenamento. O cmdlet remove essas pastas do ponto de migração de estado. Um ponto de migração de estado armazena dados de estado do usuário quando migra um computador para um novo sistema operacional.
Type: | StorageDirectoryData[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Especifica o código do site para um site do Configuration Manager.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteSystemServerName
Especifica o nome do host para um ponto de migração de estado.
Type: | String |
Aliases: | Name, ServerName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeDeleteAfter
Especifica o tempo de espera após o computador de destino baixar dados para excluir esses dados. Especifique uma unidade de tempo usando o parâmetro TimeUnit. Para excluir dados imediatamente, especifique um valor de $True para o parâmetro DeleteImmediately.
Type: | Int32 |
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 esse parâmetro são: Dias e Horas.
Type: | IntervalType |
Accepted values: | Hours, Days |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject