Start-CMDistributionPointUpgrade
Atualiza um ponto de distribuição compartilhado.
Sintaxe
Start-CMDistributionPointUpgrade
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-AllowRespondIncomingPxeRequest <Boolean>]
[-CertificatePassword <SecureString>]
-CertificatePath <String>
[-ClientCommunicationMode <ComputerCommunicationType>]
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentValidationPriority <Priority>]
-DestinationSiteCode <String>
[-EnableAnonymous <Boolean>]
[-EnableNonWdsPxe <Boolean>]
[-EnablePxeSupport <Boolean>]
[-EnableUnknownComputerSupport <Boolean>]
[-ForceWhenDuplicateCertificate <Boolean>]
[-InitiateConnection <Boolean>]
-InputObject <IResultObject>
[-InstallationAccount <IResultObject>]
[-InstallIis <Boolean>]
[-MacAddressForRespondingPxeRequest <String[]>]
[-MinFreeSpaceMB <Int32>]
[-PathForSavingMigratedPackage <String>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PublicFqdn <String>]
[-PxePassword <SecureString>]
[-PxeServerResponseDelaySec <Int32>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMDistributionPointUpgrade
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-AllowRespondIncomingPxeRequest <Boolean>]
-CertificateExpirationTimeUtc <DateTime>
[-ClientCommunicationMode <ComputerCommunicationType>]
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentValidationPriority <Priority>]
-DestinationSiteCode <String>
[-EnableAnonymous <Boolean>]
[-EnableNonWdsPxe <Boolean>]
[-EnablePxeSupport <Boolean>]
[-EnableUnknownComputerSupport <Boolean>]
[-InitiateConnection <Boolean>]
-InputObject <IResultObject>
[-InstallationAccount <IResultObject>]
[-InstallIis <Boolean>]
[-MacAddressForRespondingPxeRequest <String[]>]
[-MinFreeSpaceMB <Int32>]
[-PathForSavingMigratedPackage <String>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PublicFqdn <String>]
[-PxePassword <SecureString>]
[-PxeServerResponseDelaySec <Int32>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Start-CMDistributionPointUpgrade atualiza um ponto de distribuição compartilhado para um ponto de distribuição Configuration Manager.
Ao migrar de uma hierarquia de origem Configuration Manager 2007, você pode atualizar um ponto de distribuição compartilhado para torná-lo um ponto de distribuição Configuration Manager. Você pode atualizar pontos de distribuição em sites primários e sites secundários. O processo de atualização remove o ponto de distribuição da hierarquia Configuration Manager 2007 e o torna um servidor do sistema de sites na hierarquia Configuration Manager. Esse processo também copia o conteúdo existente que está no ponto de distribuição para um novo local no computador do ponto de distribuição. Em seguida, o processo de atualização modifica a cópia do conteúdo para criar o Configuration Manager repositório de instância única para uso com Configuration Manager implantação de conteúdo. Portanto, ao atualizar um ponto de distribuição, você não precisa redistribuir o conteúdo migrado hospedado no ponto de distribuição Configuration Manager 2007.
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: atualizar um ponto de distribuição compartilhado
O primeiro comando obtém o objeto de ponto de distribuição que tem a ID 6617708D-0F98-4898-8D05-9E882C23DCB2 e armazena o objeto na variável $CIObj.
O segundo comando atualiza o ponto de distribuição compartilhado armazenado em $CIObj para o site Configuration Manager que tem o código do site CM1. O comando especifica o caminho de importação para o certificado emitido por PKI que o ponto de distribuição usa e especifica que o ponto de distribuição pode pré-estágio de conteúdo.
$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"
Parâmetros
-AllowFallbackForContent
Indica se os clientes podem usar um local de origem de fallback para conteúdo.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AllowPreStaging
Indica se o ponto de distribuição pode pré-estágio de conteúdo.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AllowRespondIncomingPxeRequest
Indica se o ponto de distribuição pode responder a solicitações de PXE (ambiente de execução de pré-inicialização).
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CertificateExpirationTimeUtc
Especifica a data e a hora em que o certificado expira.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CertificatePassword
Especifica a senha, como uma cadeia de caracteres segura, para o certificado de cliente PKI (infraestrutura de chave pública) para o ponto de distribuição.
Tipo: | SecureString |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CertificatePath
Especifica o caminho de importação do certificado emitido pelo PKI que o ponto de distribuição usa.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ClientCommunicationMode
Tipo: | ComputerCommunicationType |
Valores aceitos: | Http, Https |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ClientConnectionType
Especifica o tipo de conexão do cliente. Os valores válidos são:
- Internet
- InternetAndIntranet
- Intranet
Tipo: | ClientConnectionTypes |
Valores aceitos: | Intranet, Internet, InternetAndIntranet |
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: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContentValidationPriority
Especifica a prioridade de validação de conteúdo. Os valores válidos são:
- Alto
- Mais Alta
- Baixo
- Mais Baixo
- Médio
O valor padrão é Menor.
Tipo: | Priority |
Valores aceitos: | Lowest, Low, Medium, High, Highest |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DestinationSiteCode
Tipo: | String |
Aliases: | SiteCode |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
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 |
-EnableAnonymous
Indica se o ponto de distribuição permite conexões anônimas de Configuration Manager clientes para a biblioteca de conteúdo.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EnableNonWdsPxe
Indica se o respondente PXE Configuration Manager está habilitado no ponto de distribuição. Quando você habilita um respondente PXE sem o WDS (Serviço de Implantação do Windows), Configuration Manager instala seu serviço de respondente PXE no ponto de distribuição.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EnablePxeSupport
Indica se é necessário habilitar o PXE no ponto de distribuição.
Quando você habilita o PXE, Configuration Manager instala os Serviços de Implantação do Windows no servidor, se necessário. O Serviço de Implantação do Windows é o serviço que executa a inicialização PXE para instalar sistemas operacionais. Depois de criar o ponto de distribuição, Configuration Manager instala um provedor nos Serviços de Implantação do Windows que usa as funções de inicialização PXE.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EnableUnknownComputerSupport
Indica se o suporte para computadores desconhecidos está habilitado. Computadores desconhecidos são computadores que não são gerenciados por Configuration Manager.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWhenDuplicateCertificate
Indica se Configuration Manager substitui um certificado duplicado ao importar um certificado de cliente PKI para o ponto de distribuição.
Tipo: | Boolean |
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 |
-InitiateConnection
Indica se o ponto de distribuição inicia a conexão com os clientes.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Tipo: | IResultObject |
Aliases: | SharedDistributionPoint |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-InstallationAccount
Especifica uma conta de instalação do sistema de site. Configuration Manager serviço 2007 Gerenciador de Componentes de Site usa contas de instalação do sistema de sites para instalar, reinstalar, desinstalar e configurar sistemas de site.
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InstallIis
Tipo: | Boolean |
Aliases: | InstallInternetServer |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MacAddressForRespondingPxeRequest
Especifica uma matriz de endereços MAC (controlador de acesso de mídia) que o ponto de distribuição usa para responder a solicitações de PXE (ambiente de execução de pré-inicialização).
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MinFreeSpaceMB
Especifica a quantidade de espaço livre em uma unidade antes de Configuration Manager escolhe uma unidade diferente e continua o processo de cópia para essa unidade. Os arquivos de conteúdo podem abranger várias unidades.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PathForSavingMigratedPackage
Especifica o caminho para uma cópia do conteúdo migrado.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PrimaryContentLibraryLocation
Especifica o local de conteúdo primário. Configuration Manager copia o conteúdo para o local de conteúdo primário até que a quantidade de espaço livre atinja o valor especificado para o parâmetro MinFreeSpaceMB. Os valores válidos são:
- Automático.
- Letra de unidade de A: até Z:.
Tipo: | DriveType |
Valores aceitos: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PrimaryPackageShareLocation
Especifica o local do compartilhamento de pacote primário. Configuration Manager copia o conteúdo para o local de compartilhamento de pacote primário até que a quantidade de espaço livre atinja o valor especificado para o parâmetro MinFreeSpaceMB. Os valores válidos são:
- Automático.
- Letra de unidade de A: até Z:.
Tipo: | DriveType |
Valores aceitos: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PublicFqdn
Especifica o FQDN (nome de domínio totalmente qualificado) do servidor do sistema de sites que hospeda o ponto de distribuição.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PxePassword
Tipo: | SecureString |
Aliases: | ComputersUsePxePassword |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PxeServerResponseDelaySec
Tipo: | Int32 |
Aliases: | PxeServerResponseDelaySeconds |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SecondaryContentLibraryLocation
Especifica o local de conteúdo secundário. Os valores válidos são:
- Automático.
- Letra de unidade de A: até Z:.
Tipo: | DriveType |
Valores aceitos: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SecondaryPackageShareLocation
Especifica o local de compartilhamento de pacote secundário. Os valores válidos são:
- Automático.
- Letra de unidade de A: até Z:.
Tipo: | DriveType |
Valores aceitos: | Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserDeviceAffinity
Especifique como o ponto de distribuição associa os usuários ao computador de destino para implantações PXE. Os valores válidos são:
- AllowWithAutomaticApproval
- AllowWithManualApproval
- DoNotUse
Tipo: | UserDeviceAffinityType |
Valores aceitos: | DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ValidateContentSchedule
Especifica um objeto CMSchedule. Um objeto CMSchedule define o cronograma para validar a integridade dos arquivos de conteúdo no ponto de distribuição. Para criar um objeto CMSchedule, use o cmdlet New-CMSchedule .
Tipo: | IResultObject |
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: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
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