New-CMBootableMedia

  • Artigo

SINOPSE

Criar meios de comunicação insutilizáveis.

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>]

DESCRIÇÃO

Este cmdlet cria meios usados para implantar um SO. Os meios de arranque contêm a imagem de arranque, comandos prestat opcionais e ficheiros associados e ficheiros Do Gestor de Configuração. Utilize suportes de arranque para instalar uma nova versão de Windows num novo computador (metal nu), ou para substituir um computador existente e transferir definições.

Nota

Este cmdlet requer permissões elevadas para ser executado.

Para obter mais informações, consulte a visão geral dos meios de comunicação da sequência de tarefas.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXEMPLOS

Exemplo 1: Criar meios de comunicação insutilizáveis

O primeiro comando obtém o objeto de imagem de arranque chamado Imagem boot (x64) e armazena-o na variável $BootImage. O segundo comando obtém o papel de ponto de distribuição para SiteServer01.Contoso.com e armazena-o na variável $DistributionPoint. O terceiro comando obtém o papel de ponto de gestão para SiteServer02.Contoso.com e armazena-o na variável $ManagementPoint. O último comando cria meios de arranque em 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 Windows o indique a elevar as permissões do seu administrador com o Controlo de Conta de Utilizador (UAC). Este cmdlet requer permissões elevadas para ser executado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AllowUnattend

Adicione este parâmetro para permitir uma implantação de SO sem supervisão. Uma implementação de SO não acompanhada não solicita a configuração da rede ou sequências de tarefas opcionais.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AllowUnknownMachine

Adicione este parâmetro para permitir que o Gestor de Configuração provisa computadores desconhecidos. Um computador desconhecido é um computador que o site ainda não descobriu.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-BootImage

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

Type: IResultObject
Parameter Sets: (All)
Aliases: BootImagePackage

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

-CertificateExpireTime

Se criar um certificado de comunicação auto-assinado para comunicação HTTP, este parâmetro especifica a data e hora de validade do certificado. Especifique uma data suficientemente no futuro. Quando este certificado expirar, não pode utilizar os meios de comunicação. Utilize o parâmetro -CertificateStartTime para definir a data de início.

Por exemplo:

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

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Password de CertificadoPassword

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.

Type: SecureString
Parameter Sets: (All)
Aliases:

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

- CertificatePath

Especifique o caminho para um certificado PKI para 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 com o cliente HTTPS.

Type: String
Parameter Sets: (All)
Aliases:

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

-CertificateStartTime

Para criar um certificado auto-assinado 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 validade. Não podes usar os meios de comunicação até esta data.

Por exemplo:

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

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Ponto de Distribuição

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

Type: IResultObject[]
Parameter Sets: (All)
Aliases: DistributionPoints

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

-Force

Executar o comando sem pedir confirmação.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-FormatoMedia

Se o MediaType Usb for, pode adicionar este parâmetro para formatar a unidade USB amovível como FAT32, e torná-lo bootable.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ManagementPoint

Especifique um ou mais objetos de ponto de gestão que os meios de comunicação usam na comunicação inicial. Utilize o parâmetro -MediaMode para determinar como o meio comunica quando funciona. Para obter este objeto, utilize o cmdlet Get-CMManagementPoint.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: ManagementPoints

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

-MediaMode

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

  • Dynamic: O meio de comunicação 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 meio de comunicação comunica o ponto de gestão especificado com o parâmetro -ManagementPoint.

Type: MediaMode
Parameter Sets: (All)
Aliases:
Accepted values: Dynamic, SiteBased

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

-MediaPassword

Especifique uma palavra-passe de cadeia segura para proteger os meios de sequência de tarefa. Quando inicia um dispositivo com este meio de comunicação, tem de introduzir a palavra-passe para continuar.

Type: SecureString
Parameter Sets: (All)
Aliases:

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

-MediaType

Especificar se o suporte é um conjunto de CD/DVD ou uma unidade USB amovível.

Type: MediaInputType
Parameter Sets: (All)
Aliases:
Accepted values: Usb, CdDvd

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

-NoAutoRun

Adicione este parâmetro para incluir o ficheiro autorun.inf nos meios de comunicação. O Gestor de Configuração não o adiciona por defeito. Este ficheiro é geralmente bloqueado por produtos antimalware. Para obter mais informações sobre a funcionalidade AutoRun de Windows, consulte criar uma aplicação de CD-ROM ativada por AutoRun. Se ainda for necessário para o seu cenário, adicione este parâmetro para incluir o ficheiro.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Se o MediaType estiver CdDvd , especifique o nome e o caminho onde o Gestor de Configuração escreve os ficheiros de saída. Por exemplo, C:\output\boot.iso.

Type: String
Parameter Sets: (All)
Aliases: MediaPath, OutputPath, DriveName

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

-PrestatCommand

Especifique um comando de prestação que é executado antes da sequência de tarefas. Um comando prestart é um script ou um executável que pode interagir com o utilizador em Windows PE antes que a sequência de tarefas seja executada para instalar o SO. Se o comando não for nativo de Windows PE, use o "PrestartPackage" para incluir ficheiros para o comando.

Type: String
Parameter Sets: (All)
Aliases: PreExecCommandLine

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

-PrestartPackage

Se utilizar o parâmetro PrestartCommand, utilize este parâmetro para especificar um pacote que contenha ficheiros para o comando prestart. Para obter o objeto de embalagem, utilize o cmdlet Get-CMPackage.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

- SiteCode

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Carrinho Temporário

O processo de criação de meios de comunicação pode exigir muito espaço de unidade temporária. Por predefinição, o Gestor de Configuração utiliza o diretório temporário do utilizador atual: $env:temp . Por exemplo, C:\Users\jqpublic\AppData\Local\Temp\. Para lhe dar maior flexibilidade com o local de armazenamento destes ficheiros temporários, especifique uma localização personalizada para a realização de dados temporários.

Type: String
Parameter Sets: (All)
Aliases: TemporaryDirectory, StagingArea

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

-UserDeviceAffinity

Para suportar a gestão centrada no utilizador no Gestor de Configurações, especifique como pretende que os meios de comunicação associem os utilizadores ao computador de destino. Para obter mais informações sobre como a implementação do SISTEMA suporta a afinidade do dispositivo do utilizador, consulte os utilizadores associados com um computador de destino.

  • DoNotAllow: Não permita a afinidade do dispositivo do utilizador. Os meios de comunicação não associam os utilizadores ao computador de destino. Neste cenário, a sequência de tarefas não associa os utilizadores ao computador de destino quando implementa o SISTEMA.

  • AdministratorApproval: Permitir a afinidade do dispositivo do utilizador enquanto se aguarda a aprovação do administrador. O meio de comunicação associa os utilizadores ao computador de destino depois de conceder a aprovação. Esta funcionalidade baseia-se no âmbito da sequência de tarefas que implementa o SISTEMA. 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 SISTEMA.

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

Type: UserDeviceAffinityType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotAllow, AdministratorApproval, AutoApproval

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

-Variável

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

Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não é executado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

ENTRADAS

Nenhuma

SAÍDAS

Sistema.Objeto

NOTAS

LIGAÇÕES RELACIONADAS

Get-CMBootImage

Get-CMDistributionPoint

Get-CMManagementPoint

Get-CMPackage

New-CMPrestageMedia New-CMCaptureMedia New-CMStandaloneMedia