Share via

New-CMTSStepRequestStateStore

  • Referência
Módulo:
ConfigurationManager

Crie a etapa Do Armazenamento de Estado de Solicitação, que você pode adicionar a uma sequência de tarefas.

Syntax

New-CMTSStepRequestStateStore
   [-FallbackToAccount <Boolean>]
   [-RequestOption <RequestType>]
   [-RetryCount <Int32>]
   [-RetryTime <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria um novo objeto de etapa do Armazenamento de Estado de Solicitação. Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, consulte Sobre etapas da sequência de tarefas: Solicitar o Armazenamento de Estado.

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

Este exemplo cria um objeto para a etapa Do Armazenamento de Estado de Solicitação para capturar o estado do usuário e especifica as configurações típicas.

Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 11.

$step = New-CMTSStepRequestStateStore -Name "Request State Store" -RequestOption Capture -FallbackToAccount $false -RetryCount 3 -RetryTime 60

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Parâmetros

-Condition

Especifique um objeto condition a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets de condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Aliases:Conditions
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:None
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Adicione esse parâmetro para habilitar a opção etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.

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

-Description

Especifique uma descrição opcional para esta etapa de sequência de tarefas.

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

-Disable

Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.

Type:SwitchParameter
Aliases:DisableThisStep
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

-FallbackToAccount

Quando você definir esse valor como , se a sequência de tarefas não puder acessar o ponto de migração de estado usando a conta do computador, ele usará as credenciais da conta de acesso $true à rede para se conectar. Essa opção é menos segura porque outros computadores podem usar a conta de acesso à rede para acessar o estado armazenado. Essa opção pode ser necessária se o computador de destino não estiver ingressado no domínio.

Para obter mais informações, consulte Conta de acesso à rede.

Type:Boolean
Aliases:FallbackToNaa
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

-Name

Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.

Type:String
Aliases:StepName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequestOption

Especifique o motivo para solicitar acesso ao ponto de migração de estado:

  • Capture: Capture o estado do computador. Se o site do Configuration Manager tiver vários pontos de migração de estado ativo, esta etapa localiza um ponto de migração de estado com espaço em disco disponível. A sequência de tarefas consulta o ponto de gerenciamento de uma lista de pontos de migração de estado e avalia cada um até encontrar um que atenda aos requisitos mínimos.

  • Restore: Restaure o estado de outro computador. Se houver vários pontos de migração de estado, esta etapa localiza o ponto de migração de estado que tem o estado do computador de destino.

Type:RequestType
Accepted values:Capture, Restore
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RetryCount

Especifique o número de vezes que esta etapa tenta encontrar um ponto de migração de estado apropriado antes de falhar.

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

-RetryTime

Especifique a quantidade de tempo em segundos que a etapa de sequência de tarefas aguarda entre tentativas de repetir.

Type:Int32
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:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Nenhum

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_RequestStateStoreAction classe WMI do servidor.