Crie um arquivo de mídia pré-configurado de implantação do sistema operacional.
\n","uid":"ConfigurationManager.New-CMPrestageMedia"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMPrestageMedia":{"href":"new-cmprestagemedia","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMPrestageMedia","schemaType":"PowershellCmdlet","summary":"Crie um arquivo de mídia pré-configurado de implantação do sistema operacional.
\n","uid":"ConfigurationManager.New-CMPrestageMedia"}},"description":"O cmdlet New-CMPrestageMedia cria um arquivo para pré-configurar uma imagem do sistema operacional em um novo disco rígido. Para obter mais informações, consulte Planejar mídia pré-configurada.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
O primeiro comando obtém o objeto de ponto de gerenciamento para o servidor do sistema de sites chamado mp01.contoso.com no código de site CM1 e armazena o objeto na variável $ManagementPoint .
\nO segundo comando obtém o objeto de imagem de inicialização chamado BootImage01 e armazena o objeto na variável $BootImage .
\nO terceiro comando obtém o objeto de ponto de distribuição para o servidor do sistema de sites chamado dist01.contoso.com no código de site CM1 e armazena o objeto na variável $DistributionPoint .
\nO quarto comando obtém o objeto de imagem do sistema operacional chamado OSImagePkg01 e armazena o objeto na variável $OSImage .
\nO último comando cria um arquivo de mídia pré-configurado dinâmico chamado PrestagedMedia.wim com a imagem de inicialização armazenada no $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.
\n","title":"Exemplo 1: Criar mídia pré-configurada"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"get-cmapplication","text":"Get-CMApplication"},{"href":"get-cmbootimage","text":"Get-CMBootImage"},{"href":"get-cmdistributionpoint","text":"Get-CMDistributionPoint"},{"href":"get-cmdriverpackage","text":"Get-CMDriverPackage"},{"href":"get-cmmanagementpoint","text":"Get-CMManagementPoint"},{"href":"get-cmoperatingsystemimage","text":"Get-CMOperatingSystemImage"},{"href":"get-cmpackage","text":"Get-CMPackage"},{"href":"/mem/configmgr/osd/deploy-use/create-task-sequence-media#BKMK_PlanPrestagedMedia","text":"Planejar mídia pré-configurada"}],"module":"ConfigurationManager","name":"New-CMPrestageMedia","notes":"Aliases de cmdlet: New-CMPrestagedMedia
\n","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"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). Este cmdlet requer permissões elevadas para ser executado.
\n","name":"AllowUacPrompt","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Adicione esse parâmetro para permitir uma implantação autônoma do sistema operacional. Uma implantação de sistema operacional autônoma não solicita configuração de rede ou sequências de tarefas opcionais.
\n","name":"AllowUnattended","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Adicione esse parâmetro para permitir que o Configuration Manager provisione computadores desconhecidos. Um computador desconhecido é um computador que o site ainda não descobriu.
\n","name":"AllowUnknownMachine","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"Applications","defaultValue":"None","description":"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 por ele. 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 .
\n","name":"Application","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"BootImagePackage","defaultValue":"None","description":"Especifique um objeto de imagem de inicialização. Para obter esse objeto, use o cmdlet Get-CMBootImage .
\n","isRequired":true,"name":"BootImage","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Se você criar um certificado de mídia autoassinado para comunicação HTTP, esse parâmetro especificará a data e a hora de expiração do certificado. Especifique uma data e hora 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.
\nPor exemplo:
\n$date = [datetime]::p arseexact(\"16/11/2021\", 'MM/dd/aaaa', $null)
\n","name":"CertificateExpireTime","parameterValueGroup":"","position":"Named","type":"DateTime\n"},{"aliases":"","defaultValue":"None","description":"Se você usar o parâmetro -CertificatePath para importar um certificado PKI para comunicação HTTPS, use esse parâmetro para especificar a senha para o arquivo de certificado.
\n","name":"CertificatePassword","parameterValueGroup":"","position":"Named","type":"SecureString\n"},{"aliases":"","defaultValue":"None","description":"Especifique o caminho para um certificado PKI a ser importado. Use o parâmetro -CertificatePassword para especificar a senha para esse arquivo de certificado. Use esses parâmetros se você configurar o site para comunicação de cliente HTTPS.
\n","name":"CertificatePath","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Para criar um certificado autoassinado para comunicação HTTP, esse parâmetro especifica a data e a hora de início do certificado. Use o parâmetro -CertificateExpireTime para definir a data de expiração. Você não pode usar a mídia inicializável até essa data.
\nPor exemplo:
\n$date = [datetime]::p arseexact(\"16/11/2020\", 'DD/MM/aaaa', $null)
\n","name":"CertificateStartTime","parameterValueGroup":"","position":"Named","type":"DateTime\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"None","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Uma cadeia de caracteres opcional para especificar quem criou essa mídia, o que é útil para fins de acompanhamento. O comprimento máximo é de 50 caracteres.
\n","name":"CreatedBy","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"DistributionPoints","defaultValue":"None","description":"Especifique um ou mais objetos de ponto de distribuição para os quais você distribuiu o conteúdo dessa mídia. Para obter esse objeto, use o cmdlet Get-CMDistributionPoint .
\n","isRequired":true,"name":"DistributionPoint","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"DriverPackages, PackageDriver, PackageDrivers","defaultValue":"None","description":"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 .
\n","name":"DriverPackage","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Execute o comando sem pedir confirmação.
\n","name":"Force","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"IncludeApplicationDependencies","defaultValue":"None","description":"Adicione esse parâmetro para detectar dependências de aplicativos associadas e adicione-as a essa mídia.
\n","name":"IncludeApplicationDependency","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"ManagementPoints","defaultValue":"None","description":"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 .
\n","isRequired":true,"name":"ManagementPoint","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifique como o cliente localiza um ponto de gerenciamento para obter informações de implantação:
\n\n 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.
\n SiteBased: a mídia comunica o ponto de gerenciamento especificado com o parâmetro -ManagementPoint .
Especifique uma senha de cadeia de caracteres segura para proteger a mídia da sequência de tarefas. Ao inicializar um dispositivo com essa mídia, você precisa inserir a senha para continuar.
\n","name":"MediaPassword","parameterValueGroup":"","position":"Named","type":"SecureString\n"},{"aliases":"","defaultValue":"None","description":"Adicione este parâmetro para incluir o arquivo autorun.inf na mídia. O Configuration Manager não o adiciona por padrão. Esse arquivo normalmente é bloqueado por produtos antimalware. Para obter mais informações sobre o recurso AutoRun do Windows, consulte Criando um aplicativo de CD-ROM habilitado para AutoRun. Se ainda for necessário para o seu cenário, adicione este parâmetro para incluir o arquivo.
\n","name":"NoAutoRun","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"OperatingSystemImagePackage","defaultValue":"None","description":"Especifique um objeto de pacote de imagem do SO a ser incluído nessa mídia. Use o parâmetro OperatingSystemImageIndex para especificar o índice de imagem no pacote de imagens. Para obter esse objeto, use o cmdlet Get-CMOperatingSystemImage .
\n","isRequired":true,"name":"OperatingSystemImage","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Especifique o índice de imagem no pacote de imagem do parâmetro OperatingSystemImage .
\n","name":"OperatingSystemImageIndex","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"Packages","defaultValue":"None","description":"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 .
\n","name":"Package","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"MediaPath, OutputPath, DriveName","defaultValue":"None","description":"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:
\nC:\\media\\prestaged1.wim\\\\server\\share\\prestaged1.wimEspecifique uma linha de comando a ser executada antes do início da sequência de tarefas. Para obter mais informações, consulte Comandos de pré-início para mídia de sequência de tarefas.
\n","name":"PrestartCommand","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Se você especificar um PrestartCommand, use esse parâmetro para especificar um pacote para conteúdo de pré-início, se necessário.
\n","name":"PrestartPackage","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Aplica-se à versão 2010 e posterior. Use esse parâmetro com o parâmetro ManagementPoint para especificar o código do site.
\n","name":"SiteCode","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique um objeto de sequência de tarefas para essa mídia executar. Para obter esse objeto, use o cmdlet Get-CMTaskSequence .
\n","isRequired":true,"name":"TaskSequence","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"TemporaryDirectory, StagingArea","defaultValue":"None","description":"O processo de criação de mídia pode exigir muito espaço em disco temporário. Por padrão, 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 o local de armazenamento desses arquivos temporários, especifique um local personalizado para preparar dados temporários.
Para dar suporte ao gerenciamento centrado no usuário no Configuration Manager, especifique como você deseja que a mídia associe usuários ao computador de destino. Para obter mais informações sobre como a implantação do sistema operacional dá suporte à afinidade de dispositivo do usuário, consulte Associar usuários a um computador de destino.
\n\n DoNotAllow: não permita afinidade de dispositivo do 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 usuários ao computador de destino quando implanta o sistema operacional.
\n AdministratorApproval: permitir a aprovação pendente do administrador por afinidade de dispositivo de usuário. A mídia associa usuários ao computador de destino depois que você concede a aprovação. Essa funcionalidade se baseia 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.
\n AutoApproval: permitir a afinidade de dispositivo do usuário com a aprovação automática. A mídia associa automaticamente os usuários ao computador de destino. Essa funcionalidade se baseia 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 ao implantar o sistema operacional no computador de destino.
Especifique uma tabela de hash de variáveis de sequência de tarefas a ser usada durante a implantação da sequência de tarefas dessa mídia.
\n","name":"Variable","parameterValueGroup":"","position":"Named","type":"Hashtable\n"},{"aliases":"","defaultValue":"None","description":"Um valor de cadeia de caracteres opcional para especificar uma versão para essa mídia, o que é útil para fins de acompanhamento e revisão. O comprimento máximo é de 32 caracteres.
\n","name":"Version","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"wi","defaultValue":"None","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Crie um arquivo de mídia pré-configurado de implantação do sistema operacional.
\n","syntaxes":["New-CMPrestageMedia [-ApplicationCrie um arquivo de mídia pré-configurado de implantação do sistema operacional.
\n","uid":"ConfigurationManager.New-CMPrestageMedia"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmprestagemedia?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmprestagemedia?view=sccm-ps"},"pageMetadata":"O cmdlet New-CMPrestageMedia cria um arquivo para pré-configurar uma imagem do sistema operacional em um novo disco rígido. Para obter mais informações, consulte Planejar mídia pré-configurada.\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.