Share via


New-CMTaskSequenceMedia

Cria mídia de sequência de tarefas no Configuration Manager.

Syntax

New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   [-BootableMedia]
   -BootImageDistributionPointServerName <String>
   -BootImageId <String>
   -BootImageManagementPointServerName <String[]>
   [-CommandDistributionPointServerName <String>]
   [-CommandIncludeFile <Boolean>]
   [-CommandPackageName <String>]
   [-CreateMediaSelfCertificate <Boolean>]
   [-DriveName <String>]
   [-EnablePrestartCommand <Boolean>]
   [-EnableUnknownSupport <Boolean>]
   [-ExpirationDate <DateTime>]
   [-ImportCertificatePassword <SecureString>]
   [-ImportCertificatePath <String>]
   -MediaInputType <MediaInputType>
   -MediaMode <MediaMode>
   -MediaPath <String>
   [-MediaSize <MediaSize>]
   [-Password <SecureString>]
   [-PrestartCommandLine <String>]
   -ProtectPassword <Boolean>
   [-StartDate <DateTime>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   [-CommandDistributionPointServerName <String>]
   [-CommandIncludeFile <Boolean>]
   [-CommandPackageName <String>]
   [-DriveName <String>]
   [-EnablePrestartCommand <Boolean>]
   [-IncludeApplicationDependency <Boolean>]
   -MediaInputType <MediaInputType>
   -MediaPath <String>
   [-MediaSize <MediaSize>]
   [-Password <SecureString>]
   [-PrestartCommandLine <String>]
   -ProtectPassword <Boolean>
   [-StandaloneMedia]
   -TaskSequenceDistributionPointServerName <String[]>
   -TaskSequenceId <String>
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   [-CommandIncludeFile <Boolean>]
   [-CommandPackage <IResultObject>]
   [-CommandPackageDistributionPoint <IResultObject>]
   [-DriveName <String>]
   [-EnablePrestartCommand <Boolean>]
   [-IncludeApplicationDependency <Boolean>]
   [-MediaInputType <MediaInputType>]
   -MediaPath <String>
   [-MediaSize <MediaSize>]
   [-Password <SecureString>]
   [-PrestartCommandLine <String>]
   [-ProtectPassword <Boolean>]
   [-StandaloneMedia]
   -TaskSequence <IResultObject>
   -TaskSequenceDistributionPoint <IResultObject[]>
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   [-BootableMedia]
   -BootImage <IResultObject>
   -BootImageDistributionPoint <IResultObject>
   -BootImageManagementPoint <IResultObject[]>
   [-CommandIncludeFile <Boolean>]
   [-CommandPackage <IResultObject>]
   [-CommandPackageDistributionPoint <IResultObject>]
   [-CreateMediaSelfCertificate <Boolean>]
   [-DriveName <String>]
   [-EnablePrestartCommand <Boolean>]
   [-EnableUnknownSupport <Boolean>]
   [-ExpirationDate <DateTime>]
   [-ImportCertificatePassword <SecureString>]
   [-ImportCertificatePath <String>]
   [-MediaInputType <MediaInputType>]
   [-MediaMode <MediaMode>]
   -MediaPath <String>
   [-MediaSize <MediaSize>]
   [-Password <SecureString>]
   [-PrestartCommandLine <String>]
   [-ProtectPassword <Boolean>]
   [-StartDate <DateTime>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   [-Application <IResultObject[]>]
   [-ApplicationName <String[]>]
   -BootImageDistributionPointServerName <String>
   -BootImageId <String>
   -BootImageManagementPointServerName <String[]>
   [-CommandDistributionPointServerName <String>]
   [-CommandIncludeFile <Boolean>]
   [-CommandPackageName <String>]
   [-Comment <String>]
   [-CreatedBy <String>]
   [-DriverPackage <IResultObject[]>]
   [-DriverPackageName <String[]>]
   -MediaMode <MediaMode>
   -MediaPath <String>
   -OperatingSystemImageDistributionPointServerName <String>
   [-OperatingSystemImageName <String>]
   [-OperatingSystemImagePackageId <String>]
   [-Package <IResultObject[]>]
   [-PackageName <String[]>]
   [-PrestagedMedia]
   [-PrestartCommandLine <String>]
   -ProtectPassword <Boolean>
   -TaskSequenceDistributionPointServerName <String[]>
   -TaskSequenceId <String>
   [-Variable <Hashtable>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   [-AllowUnattendedDeployment <Boolean>]
   [-Application <IResultObject[]>]
   -BootImage <IResultObject>
   -BootImageDistributionPoint <IResultObject>
   -BootImageManagementPoint <IResultObject[]>
   [-CommandIncludeFile <Boolean>]
   [-CommandPackage <IResultObject>]
   [-CommandPackageDistributionPoint <IResultObject>]
   [-Comment <String>]
   [-CreatedBy <String>]
   [-DriverPackage <IResultObject[]>]
   -MediaMode <MediaMode>
   -MediaPath <String>
   -OperatingSystemImageDistributionPoint <IResultObject>
   [-OperatingSystemImagePackage <IResultObject>]
   [-Package <IResultObject[]>]
   [-PrestagedMedia]
   [-PrestartCommandLine <String>]
   [-ProtectPassword <Boolean>]
   -TaskSequence <IResultObject>
   -TaskSequenceDistributionPoint <IResultObject[]>
   [-Variable <Hashtable>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   -BootImage <IResultObject>
   -BootImageDistributionPoint <IResultObject>
   [-CaptureMedia]
   [-DriveName <String>]
   [-MediaInputType <MediaInputType>]
   -MediaPath <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceMedia
   [-AllowUacPrompt]
   -BootImageDistributionPointServerName <String>
   -BootImageId <String>
   [-CaptureMedia]
   [-DriveName <String>]
   -MediaInputType <MediaInputType>
   -MediaPath <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMTaskSequenceMedia cria mídia de sequência de tarefas no Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: criar mídia de sequência de tarefas com a opção de mídia capturada

PS XYZ:\> New-CMTaskSequenceMedia -CaptureMediaOption -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\1.iso" -MediaInputType CDDVD -BootImageName "Boot" -DistributionPointServerName "Contoso320.Contoso319DOM.NET"

Esse comando cria a mídia de sequência de tarefas especificando o parâmetro CaptureMediaOption . O comando também especifica um valor para o parâmetro MediaPath e um valor para o parâmetro MediaInputType .

Exemplo 2: criar mídia de sequência de tarefas com a opção de mídia autônoma

PS XYZ:\> $Group = @{"6"="8";}
PS XYZ:\> New-CMTaskSequenceMedia -StandAloneMediaOption -Variable $Group -MediaInputType CDDVD -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\111 - Copy.iso" -ProtectPassword 0 -TaskSequenceId "CCC0000B" -TaskSequenceDistributionPointServerName "\\Contoso320.Contoso319DOM.NET"

O primeiro comando cria um mapeamento e armazena o resultado na variável $Group.

O segundo comando cria a mídia de sequência de tarefas especificando o parâmetro StandAloneMediaOption .

Exemplo 3: criar mídia de sequência de tarefas com a opção de mídia inicializável

PS XYZ:\> New-CMTaskSequenceMedia -BootableMediaOption -MediaInputType CDDVD -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\111 - Copy (6).iso" -MediaMode Dynamic -ProtectPassword 0 -BootImageName "boot" -DistributionPointServerName "Contoso320.Contoso319DOM.NET" -ManagementnPointNetworkOperatingSystemPath "Contoso320.Contoso319DOM.NET"

Esse comando cria a mídia de sequência de tarefas especificando o parâmetro BootableMediaOption .

Exemplo 4: criar mídia de sequência de tarefas com a opção de mídia prestada

PS XYZ:\> New-CMTaskSequenceMedia -PrestagedMediaOption -MediaMode Dynamic -MediaPath "\\Contoso320\Users\Administrator.Contoso319DOM\Desktop\DD\2.wim"  -ProtectPassword 0 -TaskSequenceId "CCC0000B" -BootImageName "boot" -DistributionPointServerName "Contoso320.Contoso319DOM.NET" -ManagementnPointNetworkOperatingSystemPath "Contoso320.Contoso319DOM.NET" -OperatingSystemImageDistributionPointServerName "Contoso320.Contoso319DOM.NET" -TaskSequenceDistributionPointServerName "\\Contoso320.Contoso319DOM.NET"

Esse comando usa o cmdlet New-CMTaskSequenceMedia para criar mídia de sequência de tarefas especificando o parâmetro PrestagedMediaOption .

Parâmetros

-AllowUacPrompt

Indica que os prompts do UAC (Controle de Conta de Usuário) são permitidos.

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

-AllowUnattendedDeployment

Indica se você permite a implantação autônoma do sistema operacional, o que não solicita configuração de rede ou sequências de tarefas opcionais.

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

-Application

Especifica aplicativos incluídos na sequência de tarefas.

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

-ApplicationName

Especifica uma matriz de nomes de aplicativos incluídos na sequência de tarefas.

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

-BootableMedia

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

-BootImage

Especifica um objeto de imagem de inicialização.

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

-BootImageDistributionPoint

Especifica um ponto de distribuição de imagem de inicialização.

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

-BootImageDistributionPointServerName

Especifica um nome do servidor de ponto de distribuição de imagem de inicialização.

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

-BootImageId

Especifica a ID do pacote de imagem de inicialização associado à mídia de sequência de tarefas.

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

-BootImageManagementPoint

Especifica um ponto de gerenciamento de imagem de inicialização.

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

-BootImageManagementPointServerName

Especifica um nome do servidor de ponto de gerenciamento de imagem de inicialização.

Type:String[]
Aliases:ManagementPointServerName, BootImageManagementPointServerNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CaptureMedia

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

-CommandDistributionPointServerName

Especifica um nome para um servidor de ponto de distribuição do qual o cmdlet adquire o pacote. O parâmetro CommandPackageName especifica o nome do pacote.

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

-CommandIncludeFile

Indica se deve incluir um arquivo.

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

-CommandPackage

Especifica um pacote de comando.

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

-CommandPackageDistributionPoint

Especifica um ponto de destrução de pacote de comando.

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

-CommandPackageName

Especifica um nome de pacote para o comando especificado pelo parâmetro CommandLine .

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

-Comment

Especifica um comentário para um arquivo de mídia prestaged.

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

-CreatedBy

Especifica o nome de um indivíduo ou organização responsável pela criação da mídia prestaged.

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

-CreateMediaSelfCertificate

Indica se a mídia inclui um certificado autoassinado. Use esse parâmetro somente em ambientes de modo misto.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-DriveName

Especifica um nome de unidade.

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

-DriverPackage

Especifica um pacote de driver.

Type:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DriverPackageName

Especifica o nome de um pacote de driver.

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

-EnablePrestartCommand

Indica se é necessário habilitar um comando prestart. Um comando prestart é um script ou executável que é executado antes da sequência de tarefas.

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

-EnableUnknownSupport

Indica se deve provisionar sistemas desconhecidos para implantação do sistema operacional.

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

-ExpirationDate

Especifica uma data de validade, no formato D.HH:MM:SS, para mídia inicializável.

Type:DateTime
Position:Named
Default value:None
Required:False
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). Você não pode combiná-lo com DisableWildcardHandling.

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

-ImportCertificatePassword

Especifica uma senha para um certificado de importação, como uma cadeia de caracteres segura. Um certificado de importação é um certificado emitido por PKI adicionado à mídia de inicialização para autenticação e comunicação do cliente com um site Configuration Manager.

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

-ImportCertificatePath

Especifica um caminho para um certificado de importação a ser adicionado à mídia de inicialização.

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

-IncludeApplicationDependency

Indica que o cmdlet detecta dependências de aplicativo associadas e as adiciona a essa mídia.

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

-MediaInputType

Especifica um tipo de entrada de mídia. Os valores aceitáveis para esse parâmetro são:

  • CDDVD
  • USB
Type:MediaInputType
Accepted values:Usb, CdDvd, Hd, Usb, CdDvd, Hd
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaMode

Especifica um modo de mídia. Os valores aceitáveis para esse parâmetro são:

  • Dinâmica
  • SiteBased
Type:MediaMode
Accepted values:Dynamic, SiteBased, Dynamic, SiteBased
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MediaPath

Especifica um caminho para a mídia.

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

-MediaSize

Especifica o tamanho da mídia. Os valores aceitáveis para esse parâmetro são:

  • Nenhum
  • Size4GB
  • Tamanho650MB
  • Size8GB
  • SizeUnlimited
Type:MediaSize
Accepted values:None, Size650MB, Size4GB, Size8GB, SizeUnlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImageDistributionPoint

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

-OperatingSystemImageDistributionPointServerName

Especifica o nome de um servidor de ponto de distribuição para uma imagem do sistema operacional.

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

-OperatingSystemImageName

Especifica o nome de uma imagem do sistema operacional.

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

-OperatingSystemImagePackage

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

-OperatingSystemImagePackageId

Especifica o identificador de um pacote de imagens do sistema operacional.

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

-Package

Especifica objetos de pacote.

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

-PackageName

Especifica uma matriz de nomes de pacote.

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

-Password

Especifica uma senha, como uma cadeia de caracteres segura.

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

-PrestagedMedia

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

-PrestartCommandLine

Especifica uma linha de comando de pré-início.

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

-ProtectPassword

Indica se é necessário proteger a mídia com uma senha.

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

-StandaloneMedia

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

-StartDate

Especifica uma data e hora de início no formato D.HH:MM:SS.

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

-TaskSequence

Especifica um objeto de sequência de tarefas.

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

-TaskSequenceDistributionPoint

Especifica um ponto de distribuição de sequência de tarefas.

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

-TaskSequenceDistributionPointServerName

Especifica uma matriz de servidores de ponto de distribuição disponíveis para uma sequência de tarefas.

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

-TaskSequenceId

Especifica uma ID para uma sequência de tarefas.

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

-UserDeviceAffinity

Especifica a afinidade do dispositivo de usuário. A afinidade do dispositivo de usuário associa os usuários a um computador de destino. Os valores aceitáveis para esse parâmetro são:

  • AdministratorApproval
  • AutoApproval
  • DoNotAllow
Type:UserDeviceAffinityType
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Variable

Especifica uma variável de sequência de tarefas. A variável de sequência de tarefas consiste em um nome e um valor.

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

-Version

Especifica as informações de versão para a mídia.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject