Condividi tramite


Start-CMDistributionPointUpgrade

Aggiorna un punto di distribuzione condiviso.

Sintassi

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>]

Descrizione

Il cmdlet Start-CMDistributionPointUpgrade aggiorna un punto di distribuzione condiviso a un punto di distribuzione di Configuration Manager.

Quando si esegue la migrazione da una gerarchia di origine di Configuration Manager 2007, è possibile aggiornare un punto di distribuzione condiviso per renderlo un punto di distribuzione di Configuration Manager. È possibile aggiornare i punti di distribuzione sia nei siti primari che nei siti secondari. Il processo di aggiornamento rimuove il punto di distribuzione dalla gerarchia di Configuration Manager 2007 e lo rende un server del sistema del sito nella gerarchia di Configuration Manager. Questo processo copia anche il contenuto esistente nel punto di distribuzione in una nuova posizione nel computer del punto di distribuzione. Il processo di aggiornamento modifica quindi la copia del contenuto per creare l'archivio a istanza singola di Configuration Manager da usare con la distribuzione del contenuto di Configuration Manager. Pertanto, quando si aggiorna un punto di distribuzione, non è necessario ridistribuire il contenuto migrato ospitato nel punto di distribuzione di Configuration Manager 2007.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiornare un punto di distribuzione condiviso

Il primo comando ottiene l'oggetto punto di distribuzione con ID 6617708D-0F98-4898-8D05-9E882C23DCB2 e archivia l'oggetto nella variabile $CIObj.

Il secondo comando aggiorna il punto di distribuzione condiviso archiviato in $CIObj al sito di Configuration Manager con il codice del sito CM1. Il comando specifica il percorso di importazione per il certificato rilasciato dall'infrastruttura a chiave pubblica usato dal punto di distribuzione e specifica che il punto di distribuzione può eseguire la pre-fase del contenuto.

$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"

Parametri

-AllowFallbackForContent

Indica se i client possono usare un percorso di origine di fallback per il contenuto.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowPreStaging

Indica se il punto di distribuzione può eseguire la pre-fase del contenuto.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowRespondIncomingPxeRequest

Indica se il punto di distribuzione può rispondere alle richieste PXE (Pre-Boot Execution Environment).

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificateExpirationTimeUtc

Specifica la data e l'ora di scadenza del certificato.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificatePassword

Specifica la password, come stringa sicura, per il certificato client dell'infrastruttura a chiave pubblica (PKI) per il punto di distribuzione.

Tipo:SecureString
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificatePath

Specifica il percorso di importazione per il certificato rilasciato dall'infrastruttura a chiave pubblica usato dal punto di distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientCommunicationMode

Tipo:ComputerCommunicationType
Valori accettati:Http, Https
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientConnectionType

Specifica il tipo di connessione client. I valori validi sono:

  • Internet
  • InternetAndIntranet
  • Intranet
Tipo:ClientConnectionTypes
Valori accettati:Intranet, Internet, InternetAndIntranet
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContentValidationPriority

Specifica la priorità di convalida del contenuto. I valori validi sono:

  • Alto
  • Highest
  • Bassa
  • Lowest
  • Medio

Il valore predefinito è Lowest.

Tipo:Priority
Valori accettati:Lowest, Low, Medium, High, Highest
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationSiteCode

Tipo:String
Alias:SiteCode
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableAnonymous

Indica se il punto di distribuzione consente connessioni anonime dai client di Configuration Manager alla raccolta contenuto.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableNonWdsPxe

Indica se il risponditore PXE di Configuration Manager è abilitato nel punto di distribuzione. Quando si abilita un risponditore PXE senza Windows Deployment Service (WDS), Configuration Manager installa il servizio risponditore PXE nel punto di distribuzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnablePxeSupport

Indica se abilitare PXE nel punto di distribuzione.

Quando si abilita PXE, Configuration Manager installa Servizi di distribuzione Windows nel server, se necessario. Servizio di distribuzione Windows è il servizio che esegue l'avvio PXE per installare i sistemi operativi. Dopo aver creato il punto di distribuzione, Configuration Manager installa un provider in Servizi di distribuzione Windows che usa le funzioni di avvio PXE.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableUnknownComputerSupport

Indica se il supporto per computer sconosciuti è abilitato. I computer sconosciuti sono computer non gestiti da Configuration Manager.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWhenDuplicateCertificate

Indica se Configuration Manager sovrascrive un certificato duplicato quando si importa un certificato client PKI per il punto di distribuzione.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InitiateConnection

Indica se il punto di distribuzione avvia la connessione con i client.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Tipo:IResultObject
Alias:SharedDistributionPoint
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InstallationAccount

Specifica un account di installazione del sistema del sito. Il servizio Gestione componenti sito di Configuration Manager 2007 usa gli account di installazione del sistema del sito per installare, reinstallare, disinstallare e configurare i sistemi del sito.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InstallIis

Tipo:Boolean
Alias:InstallInternetServer
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MacAddressForRespondingPxeRequest

Specifica una matrice di indirizzi MAC (Media Access Controller) usati dal punto di distribuzione per rispondere alle richieste PXE (Pre-Boot Execution Environment).

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinFreeSpaceMB

Specifica la quantità di spazio disponibile in un'unità prima che Configuration Manager scelga un'unità diversa e continui il processo di copia in tale unità. I file di contenuto possono estendersi su più unità.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PathForSavingMigratedPackage

Specifica il percorso di una copia del contenuto migrato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrimaryContentLibraryLocation

Specifica il percorso del contenuto primario. Configuration Manager copia il contenuto nel percorso del contenuto primario finché la quantità di spazio disponibile non raggiunge il valore specificato per il parametro MinFreeSpaceMB . I valori validi sono:

  • Automatico.
  • Lettera di unità da A: a Z:.
Tipo:DriveType
Valori accettati: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrimaryPackageShareLocation

Specifica il percorso di condivisione del pacchetto primario. Configuration Manager copia il contenuto nel percorso di condivisione del pacchetto primario finché la quantità di spazio disponibile non raggiunge il valore specificato per il parametro MinFreeSpaceMB . I valori validi sono:

  • Automatico.
  • Lettera di unità da A: a Z:.
Tipo:DriveType
Valori accettati: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PublicFqdn

Specifica il nome di dominio completo (FQDN) del server del sistema del sito che ospita il punto di distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PxePassword

Tipo:SecureString
Alias:ComputersUsePxePassword
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PxeServerResponseDelaySec

Tipo:Int32
Alias:PxeServerResponseDelaySeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SecondaryContentLibraryLocation

Specifica il percorso del contenuto secondario. I valori validi sono:

  • Automatico.
  • Lettera di unità da A: a Z:.
Tipo:DriveType
Valori accettati: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SecondaryPackageShareLocation

Specifica il percorso di condivisione del pacchetto secondario. I valori validi sono:

  • Automatico.
  • Lettera di unità da A: a Z:.
Tipo:DriveType
Valori accettati: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserDeviceAffinity

Specificare il modo in cui il punto di distribuzione associa gli utenti al computer di destinazione per le distribuzioni PXE. I valori validi sono:

  • AllowWithAutomaticApproval
  • AllowWithManualApproval
  • DoNotUse
Tipo:UserDeviceAffinityType
Valori accettati:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ValidateContentSchedule

Specifica un oggetto CMSchedule. Un oggetto CMSchedule definisce la pianificazione per la convalida dell'integrità dei file di contenuto nel punto di distribuzione. Per creare un oggetto CMSchedule, usare il cmdlet New-CMSchedule .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject