New-CMPrestageMedia
SYNOPSIS
Crie um ficheiro de mídia de implementação de SISTEMA.
SYNTAX
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 obter uma imagem de SO num novo disco rígido. Para mais informações, consulte Plano prestaged media.
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.
EXAMPLES
Exemplo 1: Criar meios de comunicação
O primeiro comando obtém o objeto de ponto de gestão do servidor do sistema de site nomeado 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 chamado BootImage01 e armazena o objeto na variável $BootImage.
O terceiro comando obtém o objeto ponto de distribuição do servidor do sistema de site nomeado 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 OS Chamado OSImagePkg01 e armazena o objeto na variável $OSImage.
O último comando cria um ficheiro de mídia dinâmico chamado PrestagedMedia.wim com a imagem de arranque armazenada em $BootImage, o ponto de distribuição armazenado em $DistributionPoint, o ponto de gestão armazenado em $ManagementPoint, e a imagem DES 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
PARAMETERS
-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
-Aplicação
Especifique uma série de objetos de aplicação para incluir como parte do ficheiro de mídia. Se a sequência de tarefas referenciar este conteúdo, primeiro procura localmente o conteúdo. Se o conteúdo não estiver nos meios de comunicação, a sequência de tarefas tenta descarregá-lo da rede normalmente. Para obter um objeto de aplicação, utilize o cmdlet Get-CMApplication.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Applications
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
-Comentário
Uma cadeia opcional para fornecer mais detalhes sobre os meios de comunicação. É útil descrever como configuraste ou como vais usar este meio de comunicação. O comprimento máximo é de 127 caracteres.
Type: String
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: None
Accept pipeline input: False
Accept wildcard characters: False
-CreatedBy
Uma cadeia opcional para especificar quem criou este suporte, o que é útil para fins de rastreio. O comprimento máximo é de 50 caracteres.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
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 o conteúdo para este meio de comunicação. 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
-DriverPackage
Especifique uma série de objetos de pacote do controlador para incluir como parte do ficheiro de mídia. Se a sequência de tarefas referenciar este conteúdo, procura localmente o conteúdo. Se o conteúdo não estiver nos meios de comunicação, a sequência de tarefas tenta descarregá-lo da rede normalmente. Para obter este objeto, utilize o cmdlet Get-CMDriverPackage.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: DriverPackages, PackageDriver, PackageDrivers
Required: False
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
-IncluirApplicationDependency
Adicione este parâmetro para detetar dependências de aplicações associadas e adicioná-las a este meio.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: IncludeApplicationDependencies
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
-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
-OperatingSystemImage
Especifique um objeto de pacote de imagem SO para incluir para este meio de comunicação. Utilize o parâmetro OperatingSystemImageIndex para especificar o índice de imagem no pacote de imagem. Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemImage.
Type: IResultObject
Parameter Sets: (All)
Aliases: OperatingSystemImagePackage
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperarSystemImageIndex
Especifique o índice de imagem no pacote de imagem a partir do parâmetro OperatingSystemImage.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Pacote
Especifique uma série de objetos de pacote para incluir no ficheiro de mídia. Se a sequência de tarefas referenciar este conteúdo, procura localmente o conteúdo. Se o conteúdo não estiver nos meios de comunicação, a sequência de tarefas tenta descarregá-lo da rede normalmente. Para obter este objeto, utilize o cmdlet Get-CMPackage.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Packages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
O caminho para o ficheiro mediático para criar. O formato é um caminho de drive/diretório ou um caminho de rede válido. Por exemplo:
C:\media\prestaged1.wim\\server\share\prestaged1.wim
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 uma linha de comando para ser executada antes do início da sequência de tarefas. Para obter mais informações, consulte os comandos de seqüência de tarefas .
Type: String
Parameter Sets: (All)
Aliases: PreExecCommandLine
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrestartPackage
Se especificar Prestar um Commmand, utilize este parâmetro para especificar um pacote para o conteúdo do prestart, se necessário.
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
-TaskSequence
Especifique um objeto de sequência de tarefa para este meio de comunicação a funcionar. Para obter este objeto, utilize o cmdlet Get-CMTaskSequence.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: True
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 sequência de tarefas variáveis a utilizar durante a implantação da sequência de tarefas deste meio de comunicação.
Type: Hashtable
Parameter Sets: (All)
Aliases: TaskSequenceVariables, Variables
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Versão
Um valor de cadeia opcional para especificar uma versão para este suporte, que é útil para fins de rastreio e revisão. O comprimento máximo é de 32 caracteres.
Type: String
Parameter Sets: (All)
Aliases:
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 funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
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.
INPUTS
Nenhuma
OUTPUTS
Sistema.Objeto
NOTAS
Pseudónimos da Cmdlet: New-CMPrestagedMedia