Start-CMDistributionPointUpgrade
Atualiza um ponto de distribuição partilhado.
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 partilhado para um ponto de distribuição do Configuration Manager.
Quando migra de uma hierarquia de origem do Configuration Manager 2007, pode atualizar um ponto de distribuição partilhado para torná-lo um ponto de distribuição do Configuration Manager. Pode atualizar pontos de distribuição em sites primários e em sites secundários. O processo de atualização remove o ponto de distribuição da hierarquia do Configuration Manager 2007 e torna-o num servidor do sistema de sites na hierarquia do Configuration Manager. Este processo também copia o conteúdo existente que está no ponto de distribuição para uma nova localização no computador do ponto de distribuição. Em seguida, o processo de atualização modifica a cópia do conteúdo para criar o arquivo de instância única do Configuration Manager para utilização com a implementação de conteúdos do Configuration Manager. Por conseguinte, quando atualiza um ponto de distribuição, não tem de redistribuir os conteúdos migrados alojados no ponto de distribuição do Configuration Manager 2007.
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: Atualizar um ponto de distribuição partilhado
O primeiro comando obtém o objeto de ponto de distribuição que tem o ID 6617708D-0F98-4898-8D05-9E882C23DCB2 e armazena o objeto na variável $CIObj.
O segundo comando atualiza o ponto de distribuição partilhado armazenado no $CIObj para o site do 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 utiliza e especifica que o ponto de distribuição pode pré-testar conteúdos.
$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 utilizar uma localização de origem de contingência para o 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é-preparar conteúdos.
| 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 pedidos de ambiente de execução pré-arranque (PXE).
| 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 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 palavra-passe, como uma cadeia segura, para o certificado de cliente de infraestrutura de chaves públicas (PKI) 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 para o certificado emitido por PKI que o ponto de distribuição utiliza.
| 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 ligação de 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 predefinido é 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
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 |
-EnableAnonymous
Indica se o ponto de distribuição permite ligações anónimas de clientes do Configuration Manager à biblioteca de conteúdos.
| 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 dispositivo de resposta PXE do Configuration Manager está ativado no ponto de distribuição. Quando ativa um dispositivo de resposta PXE sem o Serviço de Implementação do Windows (WDS), o Configuration Manager instala o respetivo serviço de resposta 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 pretende ativar o PXE no ponto de distribuição.
Quando ativa o PXE, o Configuration Manager instala os Serviços de Implementação do Windows no servidor, se necessário. O Serviço de Implementação do Windows é o serviço que executa o arranque PXE para instalar sistemas operativos. Depois de criar o ponto de distribuição, o Configuration Manager instala um fornecedor nos Serviços de Implementação do Windows que utiliza as funções de arranque 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á ativado. Os computadores desconhecidos são computadores que não são geridos pelo 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 o Configuration Manager substitui um certificado duplicado quando importa 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
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 |
-InitiateConnection
Indica se o ponto de distribuição inicia a ligaçã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 Sites. O serviço Configuration Manager 2007 Site Component Manager utiliza Contas de Instalação do Sistema de Sites para instalar, reinstalar, desinstalar e configurar sistemas de sites.
| 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 (media access controller) que o ponto de distribuição utiliza para responder a pedidos de ambiente de execução pré-arranque (PXE).
| 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 numa unidade antes de o Configuration Manager escolher uma unidade diferente e continuar o processo de cópia para essa unidade. Os ficheiros 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 a localização do conteúdo principal. O Configuration Manager copia o conteúdo para a localização do conteúdo principal até que a quantidade de espaço livre atinja o valor que especificou para o parâmetro MinFreeSpaceMB . Os valores válidos são:
- Automático.
- Letra de unidade de A: a 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 a localização da partilha do pacote principal. O Configuration Manager copia o conteúdo para a localização da partilha do pacote primário até que a quantidade de espaço livre atinja o valor que especificou para o parâmetro MinFreeSpaceMB . Os valores válidos são:
- Automático.
- Letra de unidade de A: a 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 nome de domínio completamente qualificado (FQDN) do servidor do sistema de sites que aloja 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 a localização do conteúdo secundário. Os valores válidos são:
- Automático.
- Letra de unidade de A: a 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 a localização secundária da partilha de pacotes. Os valores válidos são:
- Automático.
- Letra de unidade de A: a 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 utilizadores ao computador de destino para implementaçõ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 a agenda para validar a integridade dos ficheiros de conteúdo no ponto de distribuição. Para criar um objeto CMSchedule, utilize 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