New-CMTSStepRequestStateStore

Crea il passaggio Request State Store, che puoi aggiungere a una sequenza di attività.

Sintassi

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

Descrizione

Questo cmdlet crea un nuovo oggetto passaggio dell'archivio dello stato delle richieste. Utilizzare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per altre informazioni su questo passaggio, vedi Informazioni sui passaggi della sequenza di attività: Request State Store.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio viene creato un oggetto per il passaggio Request State Store per acquisire lo stato utente e vengono specificate le impostazioni tipiche.

Ottiene quindi un oggetto della sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 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

Parametri

-Condition

Specificare un oggetto condizione da utilizzare con questo passaggio. Per ottenere questo oggetto, utilizzare uno dei cmdlet delle condizioni della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-ContinueOnError

Aggiungere questo parametro per abilitare l'opzione del passaggio Continua in caso di errore. Quando abiliti questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.

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

-Description

Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.

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

-Disable

Aggiungi questo parametro per disabilitare questo passaggio della sequenza di attività.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-FallbackToAccount

Quando si imposta questo valore su , se la sequenza di attività non può accedere al punto di migrazione dello stato utilizzando l'account computer, utilizza le credenziali dell'account di accesso alla rete $true per connettersi. Questa opzione è meno sicura perché altri computer potrebbero utilizzare l'account di accesso alla rete per accedere allo stato archiviato. Questa opzione potrebbe essere necessaria se il computer di destinazione non è aggiunto a un dominio.

Per ulteriori informazioni, vedere Account di accesso alla rete.

Type:Boolean
Aliases:FallbackToNaa
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-Name

Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.

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

-RequestOption

Specificare il motivo per richiedere l'accesso al punto di migrazione dello stato:

  • Capture: stato di acquisizione dal computer. Se il sito di Configuration Manager dispone di più punti di migrazione dello stato attivo, questo passaggio trova un punto di migrazione dello stato con spazio su disco disponibile. La sequenza di attività esegue una query nel punto di gestione per un elenco di punti di migrazione dello stato e quindi valuta ogni punto finché non ne trova uno che soddisfa i requisiti minimi.

  • Restore: ripristinare lo stato da un altro computer. Se sono presenti più punti di migrazione dello stato, questo passaggio trova il punto di migrazione dello stato con lo stato per il computer di destinazione.

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

-RetryCount

Specificare il numero di tentativi di questo passaggio per trovare un punto di migrazione dello stato appropriato prima che si verifica un errore.

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

-RetryTime

Specificare la quantità di tempo in secondi di attesa del passaggio della sequenza di attività tra un tentativo e l'altro.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Nessuno

Output

IResultObject

Note

Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_RequestStateStoreAction WMI server.