Condividi tramite

New-CMTaskSequence

  • Riferimento
Modulo:
ConfigurationManager

Creare una sequenza di attività.

Sintassi

New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-BuildOperatingSystemImage]
   [-ClientPackagePackageId <String>]
   [-CreatedBy <String>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-ImageDescription <String>]
   [-ImageVersion <String>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   [-MaximumServerConnection <Int32>]
   -Name <String>
   -OperatingSystemFileAccount <String>
   [-OperatingSystemFileAccountPassword <SecureString>]
   -OperatingSystemFilePath <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-CaptureLocallyUsingLink <Boolean>]
   [-CaptureNetworkSetting <Boolean>]
   [-CaptureUserSetting <Boolean>]
   [-CaptureWindowsSetting <Boolean>]
   [-ClientPackagePackageId <String>]
   [-ConfigureBitLocker <Boolean>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   [-InstallOperatingSystemImage]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   -Name <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-PartitionAndFormatTarget <Boolean>]
   [-ProductKey <String>]
   [-SaveLocally <Boolean>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-UserStateMigrationToolPackageId <String>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   -Name <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-UpgradeOperatingSystem]
   -UpgradePackageId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-BootImagePackageId <String>]
   [-CustomTaskSequence]
   [-Description <String>]
   [-HighPerformance <Boolean>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una sequenza di attività. In genere si usa una sequenza di attività per distribuire un sistema operativo in un client, ma è possibile usarli per vari scopi. Per altre informazioni, vedere Gestire le sequenze di attività per automatizzare le attività.

Nota

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

Esempio

Esempio 1: Creare una sequenza di attività personalizzata

In questo esempio i parametri del cmdlet vengono innanzitutto inseriti nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.

Questo comando crea una sequenza di attività vuota con il nome Custom.

$parameters = @{
  CustomTaskSequence = $true
  Name = "Custom"
  Description = "NewCustom parameter set"
  HighPerformance = $false
  BootImagePackageId = "XYZ00002"
}

New-CMTaskSequence @parameters

Esempio 2: Creare una sequenza di attività per installare un'immagine del sistema operativo

In questo esempio i parametri del cmdlet vengono innanzitutto inseriti nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.

Questo comando crea una sequenza di attività denominata Installa immagine del sistema operativo che installa un'immagine del sistema operativo. Include anche gli altri parametri applicabili a questo scenario.

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  InstallOperatingSystemImage = $true
  Name = "Install OS image"
  Description = "NewInstallOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  CaptureNetworkSetting = $true
  CaptureUserSetting = $true
  SaveLocally = $true
  CaptureLocallyUsingLink = $true
  UserStateMigrationToolPackageId = "XYZ00001"
  CaptureWindowsSetting = $true
  ConfigureBitLocker = $true
  PartitionAndFormatTarget = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "DomainType"
  DomainAccount = "contoso\jqpublic"
  DomainName = "contoso"
  DomainOrganizationUnit = "LDAP://OU=Workstations,OU=Devices,DC=na,DC=contoso,DC=com"
  DomainPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $false
  SoftwareUpdateStyle = "All"
}

New-CMTaskSequence @parameters

Esempio 3: Creare una sequenza di attività per compilare e acquisire un sistema operativo

In questo esempio i parametri del cmdlet vengono innanzitutto inseriti nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.

Questo esempio crea una sequenza di attività denominata Compilazione e acquisizione che compila e acquisisce un'immagine del sistema operativo usando la posizione e l'account forniti. Include anche gli altri parametri applicabili a questo scenario.

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  BuildOperatingSystemImage = $true
  Name = "Build and capture"
  Description = "NewBuildOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "WorkgroupType"
  WorkgroupName = "groupwork"
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $true
  SoftwareUpdateStyle = "All"
  OperatingSystemFilePath = "\\server1\images\capture.wim"
  ImageDescription = "image description"
  ImageVersion = "image version 1"
  CreatedBy = "jqpublic"
  OperatingSystemFileAccount = "contoso\jqpublic" 
  OperatingSystemFileAccountPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
}

New-CMTaskSequence @parameters

Esempio 4: Creare una sequenza di attività per aggiornare un sistema operativo

Questo comando crea la sequenza di attività denominata Aggiornamento sul posto e specifica che aggiornerà il sistema operativo usando il pacchetto di aggiornamento con l'ID XYZ02EBA.

New-CMTaskSequence -UpgradeOperatingSystem -Name "In-place upgrade" -UpgradePackageId "XYZ02EBA" -SoftwareUpdateStyle All

Parametri

-ApplicationName

Specificare una matrice di nomi di applicazione da installare durante la sequenza di attività. Questo parametro configura il passaggio della sequenza di attività Installa applicazione .

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

-ApplyAll

Nello scenario di compilazione e acquisizione, lo stato di questo parametro determina i comportamenti seguenti:

  • $true: la sequenza di attività non formatta & partizionare il disco prima di applicare l'immagine del sistema operativo.

  • $false: la sequenza di attività include i passaggi Formato e Disco partizione prima di applicare l'immagine del sistema operativo.

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

-BootImagePackageId

Specificare l'ID di un pacchetto di immagine di avvio da usare con una sequenza di attività che distribuisce un sistema operativo. Questo valore è un ID pacchetto standard, ad esempio XYZ00005.

Questo parametro configura le proprietà della sequenza di attività.

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

-BuildOperatingSystemImage

Aggiungere questo parametro per creare una sequenza di attività per lo scenario di compilazione e acquisizione. Per altre informazioni, vedere Creare una sequenza di attività per acquisire un sistema operativo.

Type:SwitchParameter
Aliases:BuildOperatingSystemImageOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CaptureLocallyUsingLink

Quando si abilita il parametro SaveLocally per salvare le impostazioni utente e i file in locale, impostare questo parametro su $true per l'acquisizione in locale tramite collegamenti anziché copiando i file. I collegamenti usati Configuration Manager per archiviare lo stato dell'utente in locale sono definiti collegamenti rigidi.

Il cmdlet ignora questo parametro se SaveLocally è $false.

Questo parametro configura il passaggio Acquisisci stato utente .

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

-CaptureNetworkSetting

Impostare questo parametro su $true per abilitare la sequenza di attività per acquisire le impostazioni di rete. Quando si abilita questa opzione, la sequenza di attività include il passaggio Acquisisci impostazioni di rete .

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

-CaptureUserSetting

Impostare questo parametro su $true per abilitare la sequenza di attività per acquisire le impostazioni e i file utente. Quando si abilita questa opzione, la sequenza di attività include il passaggio Acquisisci stato utente . Usare anche il parametro UserStateMigrationToolPackageId .

Usare SaveLocally e CaptureLocallyUsingLink per configurare la posizione in cui la sequenza di attività salva lo stato utente.

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

-CaptureWindowsSetting

Impostare questo parametro su $true per abilitare la sequenza di attività per acquisire le impostazioni di Windows. Quando si abilita questa opzione, la sequenza di attività include il passaggio Acquisisci impostazioni di Windows .

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

-ClientPackagePackageId

Specificare l'ID del pacchetto client da installare quando viene eseguita la sequenza di attività. Questo valore è un ID pacchetto standard, ad esempio XYZ00003. L'assegnazione del sito e la configurazione client vengono eseguite automaticamente. È possibile specificare parametri di installazione aggiuntivi con il parametro InstallationProperty .

Questo parametro configura il passaggio della sequenza di attività Configura Windows e ConfigMgr .

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

-ConfigureBitLocker

Impostare questo parametro su $true per configurare la sequenza di attività da usare con BitLocker. Quando si abilita questa opzione, la sequenza di attività include i passaggi seguenti:

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

-CreatedBy

Per lo scenario di compilazione e acquisizione, specificare una stringa facoltativa nel file di immagine acquisito per chi l'ha creata. La lunghezza massima è di 255 caratteri.

Questo parametro configura il passaggio della sequenza di attività Acquisisci immagine del sistema operativo .

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

-CustomTaskSequence

Aggiungere questo parametro per creare una sequenza di attività personalizzata che non contiene passaggi. Per altre informazioni, vedere Creare una sequenza di attività personalizzata.

È quindi possibile usare i cmdlet New-CMTSStep 35 per aggiungere passaggi alla sequenza di attività personalizzata. Per altre informazioni, vedere Informazioni sui passaggi della sequenza di attività. Ogni sezione descrive i passaggi della sequenza di attività, con collegamenti ai cmdlet associati.

Type:SwitchParameter
Aliases:CustomOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specificare una descrizione facoltativa per la sequenza di attività. La lunghezza massima è di 512 caratteri. Questo parametro configura le proprietà della sequenza di attività.

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

-DomainAccount

Specificare un account con le autorizzazioni necessarie per aggiungere il computer al dominio. Usare il formato seguente: Domain\User. Per altre informazioni, vedere Chiedere l'account di aggiunta al dominio della sequenza.

Usare il parametro DomainName per specificare il nome di dominio e DomainPassword per specificare la password dell'account.

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di rete .

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

-DomainName

Specificare il nome di un dominio a cui aggiungere il computer quando esegue la sequenza di attività. Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di rete .

Usare il parametro DomainAccount per specificare un account con autorizzazioni per l'aggiunta a questo dominio. È anche possibile usare il parametro DomainOrganizationUnit per specificare un'unità organizzativa in cui creare l'account computer.

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

-DomainOrganizationUnit

Specificare un'unità organizzativa di dominio in cui creare l'account computer nel dominio. Il formato di questo valore è il percorso LDAP (Lightweight Directory Access Protocol), ad esempio: LDAP//OU=OSD staging,DC=contoso,DC=com. Specificare un'unità organizzativa nel dominio specificato nel parametro DomainName .

Se un account computer esistente si trova già in un'unità organizzativa, Active Directory non consente di modificare l'unità organizzativa e ignora questa impostazione.

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di rete .

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

-DomainPassword

Specificare una stringa sicura per la password dell'account specificato con il parametro DomainAccount .

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di rete .

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

-ForceWildcardHandling

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

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

-GeneratePassword

Impostare questo parametro su $true per generare in modo casuale la password dell'amministratore locale e disabilitare l'account. Questa configurazione è consigliata.

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di Windows .

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

-HighPerformance

Impostare questo parametro su $true per abilitare l'opzione della sequenza di attività per l'esecuzione come combinazione per il risparmio di energia a prestazioni elevate. Questo parametro configura le proprietà della sequenza di attività. Per altre informazioni, vedere Miglioramenti delle prestazioni per le combinazioni per il risparmio di energia.

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

-IgnoreInvalidApplication

Se si imposta questo parametro su $true, la sequenza di attività continua a installare le applicazioni nell'elenco se l'installazione di un'applicazione non riesce. Usare questo parametro con il parametro ApplicationName .

Questo parametro configura il passaggio della sequenza di attività Installa applicazione .

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

-ImageDescription

Per lo scenario di compilazione e acquisizione, specificare una stringa facoltativa che descrive il file di immagine acquisito. La lunghezza massima è di 255 caratteri.

Questo parametro configura il passaggio della sequenza di attività Acquisisci immagine del sistema operativo .

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

-ImageVersion

Per lo scenario di compilazione e acquisizione, specificare una stringa facoltativa come versione del file di immagine acquisito. Questo valore viene definito, non deve necessariamente essere la versione del sistema operativo. La lunghezza massima è di 32 caratteri.

Questo parametro configura il passaggio della sequenza di attività Acquisisci immagine del sistema operativo .

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

-InstallationLicensingMode

Questa impostazione si applica solo alle versioni legacy di Windows non più supportate. A partire dalla versione 2010, l'impostazione non è più visibile nell'editor della sequenza di attività. Le sequenze di attività esistenti che usano ancora questa impostazione continueranno a funzionare allo stesso modo.

Type:ServerLicensingMode
Accepted values:NonSpecify, PerSeat, PerServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstallationProperty

Specificare eventuali proprietà di installazione aggiuntive da usare quando la sequenza di attività installa il client Configuration Manager. L'assegnazione del sito e la configurazione predefinita vengono specificate automaticamente dalla sequenza di attività. Per immettere più proprietà di installazione, separarle con uno spazio. Se una proprietà contiene spazi, racchiuderla tra virgolette ("). Per altre informazioni, vedere Informazioni sui parametri e sulle proprietà di installazione client in Configuration Manager.

Questo elenco non può includere SMSSITECODE.

Questo parametro configura il passaggio della sequenza di attività Configura Windows e ConfigMgr .

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

-InstallOperatingSystemImage

Aggiungere questo parametro per creare una sequenza di attività per lo scenario di installazione dell'immagine del sistema operativo. Per altre informazioni, vedere Creare una sequenza di attività per installare un sistema operativo.

Type:SwitchParameter
Aliases:InstallOperatingSystemImageOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JoinDomain

Usare questo parametro per configurare il passaggio della sequenza di attività Applica impostazioni di rete . Il computer deve aggiungere un gruppo di lavoro o un dominio.

  • DomainType: aggiungere un dominio. Specificare anche DomainName, DomainAccount e DomainPassword. È anche possibile usare DomainOrganizationUnit.

  • WorkgroupType: partecipare a un gruppo di lavoro. Specificare anche WorkgroupName. Usare questo valore con il parametro BuildOperatingSystemImage . Nello scenario di compilazione e acquisizione, la sequenza di attività aggiunge sempre un gruppo di lavoro prima di acquisire l'immagine.

Type:JoinType
Accepted values:DomainType, WorkgroupType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LocalAdminPassword

Se non si usa l'opzione consigliata per GeneratePassword, usare questo parametro per specificare una stringa sicura come password amministratore locale.

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di Windows .

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

-MaximumServerConnection

Questa impostazione si applica solo alle versioni legacy di Windows non più supportate. A partire dalla versione 2010, l'impostazione non è più visibile nell'editor della sequenza di attività. Le sequenze di attività esistenti che usano ancora questa impostazione continueranno a funzionare allo stesso modo.

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

-Name

Specificare un nome per la sequenza di attività. La lunghezza massima è di 50 caratteri. Questo parametro configura le proprietà della sequenza di attività.

Type:String
Aliases:TaskSequenceName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemFileAccount

Per lo scenario di compilazione e acquisizione, specificare il nome di un account di dominio con autorizzazioni per la condivisione di rete specificata nel parametro OperatingSystemFilePath . Usare OperatingSystemFileAccountPassword per impostare la password dell'account.

Questo parametro configura il passaggio della sequenza di attività Acquisisci immagine del sistema operativo .

Type:String
Aliases:CaptureOperatingSystemFileAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemFileAccountPassword

Per lo scenario di compilazione e acquisizione, specificare una stringa sicura per la password di OperatingSystemFileAccount.

Questo parametro configura il passaggio della sequenza di attività Acquisisci immagine del sistema operativo .

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

-OperatingSystemFilePath

Per lo scenario di compilazione e acquisizione, specificare il percorso del file del percorso di rete usato Configuration Manager per archiviare l'immagine del sistema operativo acquisita. Il percorso include il nome del file con un'estensione .wim di file. Utilizzare OperatingSystemFileAccount e OperatingSystemFileAccountPassword per specificare un account che abbia accesso a questo percorso.

Questo parametro configura il passaggio della sequenza di attività Acquisisci immagine del sistema operativo .

Type:String
Aliases:CaptureOperatingSystemFilePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImageIndex

Specificare l'indice dell'immagine del sistema operativo da installare per il passaggio della sequenza di attività Applica immagine del sistema operativo.

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

-OperatingSystemImagePackageId

Specificare l'ID del pacchetto di immagine del sistema operativo da installare. Usare OperatingSystemImageIndex per specificare l'indice dell'immagine. Questo valore è un ID pacchetto standard, ad esempio XYZ00050.

Questo parametro configura il passaggio della sequenza di attività Applica immagine del sistema operativo.

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

-PartitionAndFormatTarget

Impostare questo parametro su $true per la sequenza di attività per partizionare e formattare il computer di destinazione prima di installare il sistema operativo.

Questo parametro configura il passaggio della sequenza di attività Formato e disco di partizione .

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

-ProductKey

Specificare il codice Product Key di Windows per l'installazione del sistema operativo.

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di Windows .

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

-SaveLocally

Se si abilita il parametro CaptureUserSetting , usare questo parametro per determinare dove la sequenza di attività salva lo stato utente acquisito:

  • $true: la sequenza di attività configura il percorso dello stato locale e acquisisce localmente usando i collegamenti anziché copiando i file. Questo valore configura il passaggio Acquisisci stato utente .

    • Usare il parametro CaptureLocallyUsingLink per configurare l'uso dei collegamenti rigidi.

  • $false: la sequenza di attività include i passaggi per usare un punto di migrazione dello stato. Configura i passaggi seguenti:

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

-SoftwareUpdateStyle

Specificare se installare gli aggiornamenti software durante la sequenza di attività. I valori determinano il tipo di distribuzione dell'aggiornamento software:

  • All: disponibile per l'installazione, tutti gli aggiornamenti software
  • Mandatory: obbligatorio per l'installazione, solo aggiornamenti software obbligatori
  • NoInstall: non installare aggiornamenti software

Questo parametro configura il passaggio della sequenza di attività Install Software Aggiornamenti.

Type:SoftwareUpdateStyleType
Accepted values:All, Mandatory, NoInstall
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeZone

Specificare il fuso orario predefinito per questa installazione di Windows. Per ottenere un oggetto fuso orario, usare il cmdlet Get-TimeZone predefinito.

Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di Windows .

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

-UpgradeOperatingSystem

Aggiungere questo parametro per creare una sequenza di attività per lo scenario di aggiornamento del sistema operativo. Per altre informazioni, vedere Creare una sequenza di attività per aggiornare un sistema operativo.

Type:SwitchParameter
Aliases:UpgradeOperatingSystemOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UpgradePackageId

Specificare l'ID del pacchetto di aggiornamento del sistema operativo da usare. Questo valore è un ID pacchetto standard, ad esempio XYZ00052.

Questo parametro configura il passaggio Aggiorna sequenza di attività del sistema operativo.

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

-UserStateMigrationToolPackageId

Quando si imposta CaptureUserSetting su $true, usare questo parametro per specificare l'ID del pacchetto USMT (User State Migration Tool). Questo valore è un ID pacchetto standard, ad esempio XYZ00012.

Questo parametro configura i passaggi Acquisisci stato utente e Ripristina stato utente .

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

-WorkgroupName

Se si imposta il parametro JoinDomain su WorkgroupType, usare questo parametro per specificare il nome del gruppo di lavoro. Questo parametro configura il passaggio della sequenza di attività Applica impostazioni di rete .

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

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequencePackage classe WMI del server.

Nel passaggio Applica impostazioni di Windows della sequenza di attività questo cmdlet imposta il valore nome utente sull'utente che esegue il cmdlet e il nome dell'organizzazione sul nome del computer in cui viene eseguito il cmdlet.

Non è possibile configurare tutte le impostazioni della sequenza di attività e dei passaggi con questo cmdlet. Per configurare altre impostazioni, usare Set-CMTaskSequence e i cmdlet Set-CMTSStep , ad esempio Set-CMTSStepApplyOperatingSystem.