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