New-CMPrestageMedia
Crie um arquivo de mídia de implantação do sistema operacional.
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 arquivo para gerar uma imagem do sistema operacional em um novo disco rígido. Para obter mais informações, consulte Planejar mídia prestaged.
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 prestaged
O primeiro comando obtém o objeto ponto de gerenciamento do servidor do sistema de site chamado 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 inicialização chamado BootImage01 e armazena o objeto na variável $BootImage .
O terceiro comando obtém o objeto de ponto de distribuição do servidor do sistema de site chamado 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 sistema operacional chamado OSImagePkg01 e armazena o objeto na variável $OSImage .
O último comando cria um arquivo de mídia prestaged dinâmico chamado PrestagedMedia.wim com a imagem de inicialização armazenada em $BootImage, o ponto de distribuição armazenado em $DistributionPoint, o ponto de gerenciamento armazenado em $ManagementPoint e a imagem do sistema operacional armazenada em $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 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 |
-Application
Especifique uma matriz de objetos de aplicativo a serem incluídos como parte do arquivo de mídia. Se a sequência de tarefas fizer referência a esse conteúdo, ela primeiro procurará localmente o conteúdo. Se o conteúdo não estiver na mídia, a sequência de tarefas tentará baixá-lo da rede normalmente. Para obter um objeto de aplicativo, use 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 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 |
-Comment
Uma cadeia de caracteres opcional para fornecer mais detalhes sobre a mídia. É útil descrever como você configurou ou como usará essa mídia. O comprimento máximo é de 127 caracteres.
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 de caracteres opcional para especificar quem criou essa mídia, que é útil para fins de acompanhamento. O comprimento máximo é de 50 caracteres.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
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 o conteúdo para essa mídia. 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 |
-DriverPackage
Especifique uma matriz de objetos de pacote de driver a serem incluídos como parte do arquivo de mídia. Se a sequência de tarefas fizer referência a esse conteúdo, ela procurará localmente o conteúdo. Se o conteúdo não estiver na mídia, a sequência de tarefas tentará baixá-lo da rede normalmente. Para obter esse objeto, use 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
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 |
-IncludeApplicationDependency
Adicione esse parâmetro para detectar dependências de aplicativo associadas e adicioná-las a essa mídia.
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 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 |
-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 |
-OperatingSystemImage
Especifique um objeto de pacote de imagem do sistema operacional a ser incluído para essa mídia. Use o parâmetro OperatingSystemImageIndex para especificar o índice de imagem no pacote de imagem. Para obter esse objeto, use 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 imagem no pacote de imagem 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 serem incluídos no arquivo de mídia. Se a sequência de tarefas fizer referência a esse conteúdo, ela procurará localmente o conteúdo. Se o conteúdo não estiver na mídia, a sequência de tarefas tentará baixá-lo da rede normalmente. Para obter esse objeto, use 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 arquivo de mídia a ser criado. 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 comando a ser executada antes do início da sequência de tarefas. Para obter mais informações, confira Comandos prestart para mídia 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 você especificar um PrestartCommand, use esse parâmetro para especificar um pacote para conteúdo prestart, 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. 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 |
-TaskSequence
Especifique um objeto de sequência de tarefas para que essa mídia seja executada. Para obter esse objeto, use 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 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 um hashtable de variáveis de sequência de tarefas a serem usadas durante a implantação da sequência de tarefas dessa mídia.
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 de caracteres opcional para especificar uma versão para essa mídia, que é útil para fins de acompanhamento e revisão. O comprimento máximo é de 32 caracteres.
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 cmdlet: New-CMPrestagedMedia
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de