New-CMPrestageMedia

Crie um ficheiro de multimédia pré-configurado de implementação do SO.

Sintaxe

New-CMPrestageMedia
   [-Application <IResultObject[]>]
   [-Comment <String>]
   [-CreatedBy <String>]
   [-DriverPackage <IResultObject[]>]
   [-IncludeApplicationDependency]
   -OperatingSystemImage <IResultObject>
   [-OperatingSystemImageIndex <Int32>]
   [-Package <IResultObject[]>]
   -TaskSequence <IResultObject>
   [-Version <String>]
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMPrestageMedia cria um ficheiro para pré-configurar uma imagem do SO num novo disco rígido. Para obter mais informações, veja Planear suportes de dados pré-configurados.

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 pré-configurados

O primeiro comando obtém o objeto do ponto de gestão para o servidor do sistema de sites com o nome mp01.contoso.com no código do site CM1 e armazena o objeto na variável $ManagementPoint .

O segundo comando obtém o objeto de imagem de arranque denominado BootImage01 e armazena o objeto na variável $BootImage .

O terceiro comando obtém o objeto de ponto de distribuição para o servidor do sistema de sites com o nome dist01.contoso.com no código do site CM1 e armazena o objeto na variável $DistributionPoint .

O quarto comando obtém o objeto de imagem do SO com o nome OSImagePkg01 e armazena o objeto na variável $OSImage .

O último comando cria um ficheiro de multimédia pré-configurado dinâmico denominado PrestagedMedia.wim com a imagem de arranque armazenada no $BootImage, o ponto de distribuição armazenado no $DistributionPoint, o ponto de gestão armazenado no $ManagementPoint e a imagem do SO armazenada no $OSImage.

$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"

New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage

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

-Application

Especifique uma matriz de objetos de aplicação a incluir como parte do ficheiro de multimédia. Se a sequência de tarefas fizer referência a este conteúdo, primeiro procura localmente o conteúdo. Se o conteúdo não estiver no suporte de dados, a sequência de tarefas tenta transferi-lo da rede normalmente. Para obter um objeto de aplicação, utilize o cmdlet Get-CMApplication .

Tipo:IResultObject[]
Aliases:Applications
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

-Comment

Uma cadeia opcional para fornecer mais detalhes sobre o suporte de dados. É útil descrever como configurou ou como irá utilizar este suporte de dados. O comprimento máximo é de 127 carateres.

Tipo:String
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:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CreatedBy

Uma cadeia opcional para especificar quem criou este suporte de dados, o que é útil para fins de controlo. O comprimento máximo é de 50 carateres.

Tipo:String
Cargo:Named
Valor padrão:None
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 o conteúdo para este suporte de dados. 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

-DriverPackage

Especifique uma matriz de objetos de pacote de controlador a incluir como parte do ficheiro de multimédia. Se a sequência de tarefas fizer referência a este conteúdo, procura localmente o conteúdo. Se o conteúdo não estiver no suporte de dados, a sequência de tarefas tenta transferi-lo da rede normalmente. Para obter este objeto, utilize o cmdlet Get-CMDriverPackage .

Tipo:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-IncludeApplicationDependency

Adicione este parâmetro para detetar dependências de aplicações associadas e adicioná-las a este suporte de dados.

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

-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

-OperatingSystemImage

Especifique um objeto de pacote de imagem do SO a incluir para este suporte de dados. Utilize o parâmetro OperatingSystemImageIndex para especificar o índice de imagens no pacote de imagem. Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemImage .

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

-OperatingSystemImageIndex

Especifique o índice de imagens no pacote de imagem a partir do parâmetro OperatingSystemImage .

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

-Package

Especifique uma matriz de objetos de pacote a incluir no ficheiro de multimédia. Se a sequência de tarefas fizer referência a este conteúdo, procura localmente o conteúdo. Se o conteúdo não estiver no suporte de dados, a sequência de tarefas tenta transferi-lo da rede normalmente. Para obter este objeto, utilize o cmdlet Get-CMPackage .

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

-Path

O caminho para o ficheiro de multimédia a criar. O formato é um caminho de unidade/diretório ou um caminho de rede válido. Por exemplo:

  • C:\media\prestaged1.wim
  • \\server\share\prestaged1.wim
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 uma linha de comandos a executar antes do início da sequência de tarefas. Para obter mais informações, veja Comandos de pré-início para suportes de dados de sequência de tarefas.

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 especificar um Pré-inícioComando, utilize este parâmetro para especificar um pacote para conteúdo de pré-início, se necessário.

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

-TaskSequence

Especifique um objeto de sequência de tarefas para que este suporte de dados seja executado. Para obter este objeto, utilize o cmdlet Get-CMTaskSequence .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
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 tabela hash de variáveis de sequência de tarefas a utilizar durante a implementação da sequência de tarefas a partir deste suporte de dados.

Tipo:Hashtable
Aliases:TaskSequenceVariables, Variables
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Version

Um valor de cadeia opcional para especificar uma versão para este suporte de dados, o que é útil para fins de controlo e revisão. O comprimento máximo é de 32 carateres.

Tipo:String
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:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object

Observações

Aliases de cmdlets: New-CMPrestagedMedia