New-CMBootableMedia

Crie suportes de dados de arranque.

Sintaxe

New-CMBootableMedia
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   [-FormatMedia]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   -MediaType <MediaInputType>
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria suportes de dados utilizados para implementar um SO. O suporte de dados de arranque contém a imagem de arranque, comandos de pré-início opcionais e ficheiros associados e ficheiros do Configuration Manager. Utilize suportes de dados de arranque para instalar uma nova versão do Windows num novo computador (bare-metal) ou para substituir um computador existente e transferir definições.

Observação

Este cmdlet requer permissões elevadas para ser executado.

Para obter mais informações, veja Descrição geral do suporte de dados de sequência de tarefas.

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: Criar suportes de dados de arranque

O primeiro comando obtém o objeto de imagem de arranque denominado Imagem de arranque (x64) e armazena-o na variável $BootImage . O segundo comando obtém a função de ponto de distribuição para SiteServer01.Contoso.com e armazena-a na variável $DistributionPoint . O terceiro comando obtém a função de ponto de gestão para SiteServer02.Contoso.com e armazena-a na variável $ManagementPoint . O último comando cria suportes de dados de arranque no modo dinâmico. Utiliza os objetos armazenados nas variáveis anteriores.

$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"

New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint

Parâmetros

-AllowUacPrompt

Adicione este parâmetro para permitir que o Windows lhe peça para elevar as permissões de administrador com o Controlo de Conta de Utilizador (UAC). Este cmdlet requer permissões elevadas para ser executado.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowUnattended

Adicione este parâmetro para permitir uma implementação automática do SO. Uma implementação automática do SO não pede a configuração da rede ou sequências de tarefas opcionais.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowUnknownMachine

Adicione este parâmetro para permitir que o Configuration Manager aprovisione computadores desconhecidos. Um computador desconhecido é um computador que o site ainda não detetou.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BootImage

Especifique um objeto de imagem de arranque. Para obter este objeto, utilize o cmdlet Get-CMBootImage .

Tipo:IResultObject
Aliases:BootImagePackage
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CertificateExpireTime

Se criar um certificado de multimédia autoassinado para comunicação HTTP, este parâmetro especifica a data e hora de expiração do certificado. Especifique um datetime suficientemente no futuro. Quando este certificado expira, não pode utilizar o suporte de dados de arranque. Utilize o parâmetro -CertificateStartTime para definir a data de início.

Por exemplo:

$date = [datetime]::p arseexact("16/11/2021", "MM/dd/aaaa", $null)

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CertificatePassword

Se utilizar o parâmetro -CertificatePath para importar um certificado PKI para comunicação HTTPS, utilize este parâmetro para especificar a palavra-passe do ficheiro de certificado.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CertificatePath

Especifique o caminho para um certificado PKI a importar. Utilize o parâmetro -CertificatePassword para especificar a palavra-passe deste ficheiro de certificado. Utilize estes parâmetros se configurar o site para comunicação de cliente HTTPS.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CertificateStartTime

Para criar um certificado autoassinado para comunicação HTTP, este parâmetro especifica a data e hora de início do certificado. Utilize o parâmetro -CertificateExpireTime para definir a data de expiração. Não pode utilizar o suporte de dados de arranque até esta data.

Por exemplo:

$date = [datetime]::p arseexact("16/11/2020", "MM/dd/aaaa", $null)

Tipo:DateTime
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:False
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

-DistributionPoint

Especifique um ou mais objetos de ponto de distribuição para os quais distribuiu a imagem de arranque. Para obter este objeto, utilize o cmdlet Get-CMDistributionPoint .

Tipo:IResultObject[]
Aliases:DistributionPoints
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Execute o comando sem pedir confirmação.

Tipo:SwitchParameter
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

-FormatMedia

Se o MediaType for Usb, pode adicionar este parâmetro para formatar a pen USB amovível como FAT32 e torná-la de arranque.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagementPoint

Especifique um ou mais objetos de ponto de gestão que o suporte de dados utiliza na comunicação inicial. Utilize o parâmetro -MediaMode para determinar como o suporte de dados comunica quando é executado. Para obter este objeto, utilize o cmdlet Get-CMManagementPoint .

Tipo:IResultObject[]
Aliases:ManagementPoints
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MediaMode

Especifique como o cliente localiza um ponto de gestão para obter informações de implementação:

  • Dynamic: o suporte de dados contacta um ponto de gestão, que redireciona o cliente para um ponto de gestão diferente com base na localização do cliente nos limites do site.

  • SiteBased: o suporte de dados comunica o ponto de gestão especificado com o parâmetro -ManagementPoint .

Tipo:MediaMode
Valores aceitos:Dynamic, SiteBased
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MediaPassword

Especifique uma palavra-passe de cadeia segura para proteger o suporte de dados de sequência de tarefas. Quando arranca um dispositivo com este suporte de dados, tem de introduzir a palavra-passe para continuar.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MediaType

Especifique se o suporte de dados é um conjunto de CD/DVD ou uma pen USB amovível.

Tipo:MediaInputType
Valores aceitos:Usb, CdDvd
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoAutoRun

Adicione este parâmetro para incluir o ficheiro autorun.inf no suporte de dados. O Configuration Manager não o adiciona por predefinição. Normalmente, este ficheiro é bloqueado por produtos antimalware. Para obter mais informações sobre a funcionalidade Execução Automática do Windows, veja Creating an AutoRun-enabled CD-ROM Application (Criar uma Aplicação CD-ROM ativada para Execução Automática). Se ainda for necessário para o seu cenário, adicione este parâmetro para incluir o ficheiro.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Se o MediaType for CdDvd, especifique o nome e o caminho onde o Configuration Manager escreve os ficheiros de saída. Por exemplo, C:\output\boot.iso.

Tipo:String
Aliases:MediaPath, OutputPath, DriveName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrestartCommand

Especifique um comando de pré-início que é executado antes da sequência de tarefas. Um comando de pré-início é um script ou um executável que pode interagir com o utilizador no Windows PE antes da execução da sequência de tarefas para instalar o SO. Se o comando não for nativo do Windows PE, utilize o PrestartPackage para incluir ficheiros para o comando .

Tipo:String
Aliases:PreExecCommandLine
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrestartPackage

Se utilizar o parâmetro PrestartCommand , utilize este parâmetro para especificar um pacote que contém ficheiros para o comando de pré-início. Para obter o objeto do pacote, utilize o cmdlet Get-CMPackage .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteCode

Aplica-se à versão 2010 e posterior. Utilize este parâmetro com o parâmetro ManagementPoint para especificar o código do site.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TemporaryFolder

O processo de criação de suportes de dados pode exigir muito espaço temporário na unidade. Por predefinição, o Configuration Manager utiliza o diretório temporário do utilizador atual: $env:temp. Por exemplo, C:\Users\jqpublic\AppData\Local\Temp\. Para lhe dar maior flexibilidade sobre onde armazenar estes ficheiros temporários, especifique uma localização personalizada para testar dados temporários.

Tipo:String
Aliases:TemporaryDirectory, StagingArea
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserDeviceAffinity

Para suportar a gestão centrada no utilizador no Configuration Manager, especifique como pretende que o suporte de dados associe utilizadores ao computador de destino. Para obter mais informações sobre como a implementação do SO suporta a afinidade dispositivo/utilizador, veja Associar utilizadores a um computador de destino.

  • DoNotAllow: não permitir a afinidade dispositivo/utilizador. O suporte de dados não associa utilizadores ao computador de destino. Neste cenário, a sequência de tarefas não associa utilizadores ao computador de destino quando implementa o SO.

  • AdministratorApproval: permitir a afinidade dispositivo/utilizador com aprovação de administrador pendente. O suporte de dados associa os utilizadores ao computador de destino depois de conceder aprovação. Esta funcionalidade baseia-se no âmbito da sequência de tarefas que implementa o SO. Neste cenário, a sequência de tarefas cria uma relação entre os utilizadores especificados e o computador de destino. Em seguida, aguarda a aprovação de um utilizador administrativo antes de implementar o SO.

  • AutoApproval: permitir afinidade dispositivo/utilizador com aprovação automática. O suporte de dados associa automaticamente os utilizadores ao computador de destino. Esta funcionalidade baseia-se nas ações da sequência de tarefas que implementa o SO. Neste cenário, a sequência de tarefas cria uma relação entre os utilizadores especificados e o computador de destino quando implementa o SO no computador de destino.

Tipo:UserDeviceAffinityType
Valores aceitos:DoNotAllow, AdministratorApproval, AutoApproval
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Variable

Especifique uma ou mais variáveis de sequência de tarefas e valores numa tabela hash. Uma variável de sequência de tarefas é um par de nome/valor que é utilizado durante a implementação da sequência de tarefas.

Tipo:Hashtable
Aliases:TaskSequenceVariables, Variables
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object