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