Compartilhar via

New-CMBootableMedia

  • Referência
Módulo:
ConfigurationManager

Crie mídia inicializável.

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

Esse cmdlet cria mídia usada para implantar um sistema operacional. A mídia inicializável contém a imagem de inicialização, comandos de prestart opcionais e arquivos associados e arquivos Configuration Manager. Use mídia inicializável para instalar uma nova versão do Windows em um novo computador (bare metal) ou para substituir um computador existente e configurações de transferência.

Observação

Esse cmdlet requer permissões elevadas para ser executado.

Para obter mais informações, confira Visão geral da mídia da sequência de tarefas.

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 inicializável

O primeiro comando obtém o objeto de imagem de inicialização chamado Imagem de inicialização (x64) e o armazena na variável $BootImage . O segundo comando obtém a função de ponto de distribuição para SiteServer01.Contoso.com e o armazena na variável $DistributionPoint . O terceiro comando obtém a função de ponto de gerenciamento para SiteServer02.Contoso.com e o armazena na variável $ManagementPoint . O último comando cria mídia inicializável no modo dinâmico. Ele usa 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 esse parâmetro para permitir que o Windows solicite que você eleve suas permissões de administrador com o UAC (Controle de Conta de Usuário). Esse 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 esse parâmetro para permitir uma implantação autônoma do sistema operacional. Uma implantação autônoma do sistema operacional não solicita configuração de 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 esse parâmetro para permitir que Configuration Manager provisione computadores desconhecidos. Um computador desconhecido é um computador que o site ainda não descobriu.

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 inicialização. Para obter esse objeto, use 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 você criar um certificado de mídia autoassinado para comunicação HTTP, esse parâmetro especifica a data e a hora de validade do certificado. Especifique um datetime suficientemente no futuro. Quando esse certificado expirar, você não poderá usar a mídia inicializável. Use o parâmetro -CertificateStartTime para definir a data de início.

Por exemplo:

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

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

-CertificatePassword

Se você usar o parâmetro -CertificatePath para importar um certificado PKI para comunicação HTTPS, use esse parâmetro para especificar a senha do arquivo 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 ser importado. Use o parâmetro -CertificatePassword para especificar a senha deste arquivo de certificado. Use esses parâmetros se você configurar o site para comunicação do 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 a hora de início do certificado. Use o parâmetro -CertificateExpireTime para definir a data de validade. Você não pode usar a mídia inicializável até esta data.

Por exemplo:

$date = [datetime]::p arseexact("16/11/2020", 'MM/dd/yyyy', $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

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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 aos quais você distribuiu a imagem de inicialização. Para obter esse objeto, use 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

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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, você poderá adicionar esse parâmetro para formatar a unidade USB removível como FAT32 e torná-la inicializável.

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 gerenciamento que a mídia usa na comunicação inicial. Use o parâmetro -MediaMode para determinar como a mídia se comunica quando é executada. Para obter esse objeto, use 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 encontra um ponto de gerenciamento para obter informações de implantação:

  • Dynamic: a mídia entra em contato com um ponto de gerenciamento, que redireciona o cliente para um ponto de gerenciamento diferente com base na localização do cliente nos limites do site.

  • SiteBased: a mídia comunica o ponto de gerenciamento 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 senha de cadeia de caracteres segura para proteger a mídia de sequência de tarefas. Ao inicializar um dispositivo com essa mídia, você precisa inserir a senha 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 a mídia é um conjunto de CD/DVD ou uma unidade USB removí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 esse parâmetro para incluir o arquivo autorun.inf na mídia. Configuration Manager não o adiciona por padrão. Esse arquivo geralmente é bloqueado por produtos antimalware. Para obter mais informações sobre o recurso De Execução Automática do Windows, consulte Criando um aplicativo CD-ROM habilitado para Execução Automática. Se ainda for necessário para o cenário, adicione esse parâmetro para incluir o arquivo.

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 em que Configuration Manager grava os arquivos 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 prestart executado antes da sequência de tarefas. Um comando prestart é um script ou um executável que pode interagir com o usuário no Windows PE antes que a sequência de tarefas seja executada para instalar o sistema operacional. Se o comando não for nativo do Windows PE, use o PrestartPackage para incluir arquivos 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 você usar o parâmetro PrestartCommand , use esse parâmetro para especificar um pacote que contém arquivos para o comando prestart. Para obter o objeto de pacote, use 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. Use esse 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 mídia pode exigir muito espaço de unidade temporária. Por padrão, Configuration Manager usa o diretório temporário do usuário atual: $env:temp. Por exemplo, C:\Users\jqpublic\AppData\Local\Temp\. Para oferecer maior flexibilidade com onde armazenar esses arquivos temporários, especifique um local personalizado para preparo de 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 dar suporte ao gerenciamento centrado no usuário no Configuration Manager, especifique como deseja que a mídia associe os usuários ao computador de destino. Para obter mais informações sobre como a implantação do sistema operacional dá suporte à afinidade do dispositivo de usuário, consulte Associar usuários a um computador de destino.

  • DoNotAllow: não permita afinidade de dispositivo de usuário. A mídia não associa usuários ao computador de destino. Nesse cenário, a sequência de tarefas não associa os usuários ao computador de destino quando implanta o sistema operacional.

  • AdministratorApproval: permitir a aprovação do administrador pendente de afinidade do dispositivo de usuário. A mídia associa os usuários ao computador de destino após a aprovação. Essa funcionalidade é baseada no escopo da sequência de tarefas que implanta o sistema operacional. Nesse cenário, a sequência de tarefas cria uma relação entre os usuários especificados e o computador de destino. Em seguida, ele aguarda a aprovação de um usuário administrativo antes de implantar o sistema operacional.

  • AutoApproval: permitir a afinidade do dispositivo de usuário com a aprovação automática. A mídia associa automaticamente os usuários ao computador de destino. Essa funcionalidade é baseada nas ações da sequência de tarefas que implanta o sistema operacional. Nesse cenário, a sequência de tarefas cria uma relação entre os usuários especificados e o computador de destino quando implanta o sistema operacional 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 e valores de sequência de tarefas em um hashtable. Uma variável de sequência de tarefas é um par de nome/valor que é usado durante a implantaçã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