New-CMTSStepRequestStateStore
Crie o passo Pedir Armazenamento de Estados , que pode adicionar a uma sequência de tarefas.
Sintaxe
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 passo Solicitar Armazenamento de Estados . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja Acerca dos passos da sequência de tarefas: Pedir Armazenamento de Estados.
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
Este exemplo cria um objeto para o passo Pedir Armazenamento de Estados para capturar o estado do utilizador e especifica as definições típicas.
Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à 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 de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Tipo: | IResultObject[] |
Aliases: | Conditions |
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: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContinueOnError
Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Description
Especifique uma descrição opcional para este passo de sequência de tarefas.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Disable
Adicione este parâmetro para desativar este passo de sequência de tarefas.
Tipo: | SwitchParameter |
Aliases: | DisableThisStep |
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 |
-FallbackToAccount
Quando define este valor como $true
, se a sequência de tarefas não conseguir aceder ao ponto de migração de estado com a conta de computador, este utiliza as credenciais da conta de acesso à rede para ligar. Esta opção é menos segura porque outros computadores podem utilizar a conta de acesso à rede para aceder ao estado armazenado. Esta opção poderá ser necessária se o computador de destino não estiver associado a um domínio.
Para obter mais informações, veja Conta de acesso à rede.
Tipo: | Boolean |
Aliases: | FallbackToNaa |
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 |
-Name
Especifique um nome para este passo para identificá-lo na sequência de tarefas.
Tipo: | String |
Aliases: | StepName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RequestOption
Especifique o motivo para pedir acesso ao ponto de migração de estado:
Capture
: estado de captura do computador. Se o site do Configuration Manager tiver vários pontos de migração de estado ativos, este passo localiza um ponto de migração de estado com espaço em disco disponível. A sequência de tarefas consulta o ponto de gestão de uma lista de pontos de migração de estado e, em seguida, avalia cada um até encontrar um que cumpra os requisitos mínimos.Restore
: restaurar o estado a partir de outro computador. Se existirem vários pontos de migração de estado, este passo localiza o ponto de migração de estado que tem o estado do computador de destino.
Tipo: | RequestType |
Valores aceitos: | Capture, Restore |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RetryCount
Especifique o número de vezes que este passo tenta encontrar um ponto de migração de estado adequado antes de falhar.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RetryTime
Especifique a quantidade de tempo em segundos que o passo da sequência de tarefas aguarda entre tentativas de repetição.
Tipo: | Int32 |
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: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_RequestStateStoreAction classe WMI de servidor.