New-CMSecondarySite

Cree un sitio secundario.

Sintaxis

New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificateExpirationTimeUtc <DateTime>
   [-ContentMonitoringPriority <Priority>]
   [-CreateSelfSignedCertificate]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache]
   [-Http]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificateExpirationTimeUtc <DateTime>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-CreateSelfSignedCertificate]
   [-EnableBranchCache]
   [-Https]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificatePassword <SecureString>
   -CertificatePath <String>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-EnableBranchCache]
   [-ForceWhenDuplicateCertificate <Boolean>]
   [-Https]
   [-ImportCertificate]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificatePassword <SecureString>
   -CertificatePath <String>
   [-ContentMonitoringPriority <Priority>]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache]
   [-ForceWhenDuplicateCertificate <Boolean>]
   [-Http]
   [-ImportCertificate]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-CMSecondarySite crea un sitio secundario. Para obtener más información, consulte Preparación para instalar sitios de Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Creación de un sitio secundario

Este primer comando crea un objeto de configuración de SQL Server. Este objeto especifica que Microsoft SQL Server Express se copia en un sitio secundario de Configuration Manager. El comando almacena el objeto en la variable $CIObj .

El segundo comando crea un sitio secundario denominado Sitio remoto de Contoso que tiene el código de sitio CM2 en el servidor denominado server2.corp.contoso.com. El comando especifica el objeto de configuración de SQL Server para el sitio secundario almacenado en $CIObj. El comando especifica el sitio primario para el sitio secundario que tiene el código de sitio CM1.

$CIObj = New-CMSqlServerSetting -CopySqlServerExpressOnSecondarySite

New-CMSecondarySite -CertificateExpirationTimeUtc "2/1/2020 12:00 AM" -CreateSelfSignedCertificate -Https -InstallationSourceFile "\\ContosoServer1\SourceFiles" -InstallInternetServer $True -ParentSiteCode "CM1" -ServerName "server2.corp.contoso.com" -SiteCode "CM2" -SiteName "Contoso remote site" -SqlServerSetting $CIObj

Parámetros

-AllowFallbackForContent

Indica si los clientes pueden usar una ubicación de origen de reserva para el contenido.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowPreStaging

Indica si el sitio secundario puede preconfigurar el contenido.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BoundaryGroup

Especifique una matriz de objetos de grupo de límites para este sistema de sitio. Para obtener este objeto, use el cmdlet Get-CMBoundaryGroup .

Tipo:IResultObject[]
Alias:BoundaryGroups
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CertificateExpirationTimeUtc

Especifica la fecha y hora en que expira el certificado autofirmado para un punto de distribución en el sitio secundario.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CertificatePassword

Especifica la contraseña del certificado importado de PKI para el punto de distribución.

Tipo:SecureString
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CertificatePath

Especifica la ruta de acceso de importación para el certificado emitido por PKI que usa el punto de distribución. Este parámetro se aplica cuando el sitio secundario ha instalado y configurado IIS para crear un punto de distribución.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClientConnectionType

Especifica el tipo de conexión de cliente.

Tipo:ClientConnectionTypes
Valores aceptados:Intranet, Internet, InternetAndIntranet
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ContentMonitoringPriority

Especifica la prioridad de supervisión de contenido.

Tipo:Priority
Valores aceptados:Lowest, Low, Medium, High, Highest
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CreateSelfSignedCertificate

Indica que el sitio secundario crea un certificado autofirmado para el punto de distribución.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableAnonymous

Indica si los equipos cliente se comunican de forma anónima con el punto de distribución. Este parámetro se aplica cuando el sitio secundario ha instalado y configurado IIS para crear un punto de distribución.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableBranchCache

Indica que los clientes que usan Windows BranchCache pueden descargar contenido de un punto de distribución local.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWhenDuplicateCertificate

Indica si Configuration Manager sobrescribe un certificado duplicado al importar un certificado de cliente PKI para el sitio secundario.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Http

Indica que los equipos cliente se comunican con el punto de distribución mediante HTTP. Este parámetro se aplica cuando el sitio secundario ha instalado y configurado IIS para crear un punto de distribución. \

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Https

Indica que los equipos cliente se comunican con el punto de distribución mediante HTTPS. Este parámetro se aplica cuando el sitio secundario ha instalado y configurado IIS para crear un punto de distribución.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImportCertificate

Indica que el cmdlet importa un certificado PKI en lugar de usar un certificado autofirmado para el punto de distribución.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstallationFolder

Especifica la carpeta de instalación en el servidor de sitio secundario donde el cmdlet instala los archivos de sitio.

Tipo:String
Alias:InstallDir
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstallationSourceFile

Especifica una matriz de objetos de archivo de origen de instalación para Configuration Manager. Para obtener este objeto, use el cmdlet New-CMInstallationSourceFile .

Tipo:IResultObject[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstallInternetServer

Especifica si se va a instalar y configurar IIS si Configuration Manager lo requiere. Este parámetro debe ser $True antes de que el cmdlet instale el rol de sistema de sitio para el punto de distribución en el sitio secundario.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MinFreeSpaceMB

Especifica la cantidad de espacio, en megabytes, que se va a reservar en cada unidad que use el punto de distribución. Este valor determina el espacio libre restante en la unidad después de que la distribución almacene contenido en la unidad.

A partir de la versión 2107, el espacio libre mínimo predeterminado ha cambiado de 200 MB a 500 MB.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrimaryContentLibraryLocation

Especifica una ubicación de la biblioteca de contenido principal.

Tipo:DriveType
Valores aceptados: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrimaryPackageShareLocation

Especifica una ubicación del recurso compartido del paquete principal.

Tipo:DriveType
Valores aceptados: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrimarySiteCode

Especifique el código de sitio de tres caracteres del sitio primario.

Tipo:String
Alias:ParentSiteCode
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryContentLibraryLocation

Especifica una ubicación de biblioteca de contenido secundaria.

Tipo:DriveType
Valores aceptados: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondaryPackageShareLocation

Especifica una ubicación de recurso compartido del paquete secundario.

Tipo:DriveType
Valores aceptados: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecondarySiteCode

Especifique un código de sitio de tres caracteres único para el sitio secundario.

Tipo:String
Alias:SiteCode
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerName

Especifique el nombre de dominio completo (FQDN) del servidor que se usará como servidor de sitio secundario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SiteName

Especifica el nombre del sitio que ayuda a identificar el sitio secundario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SqlServerSetting

Especifica una matriz de objeto de configuración de SQL Server en Configuration Manager. Para obtener este objeto, use el cmdlet New-CMSqlServerSetting .

Tipo:IResultObject[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ValidateContentSchedule

Especifica un objeto que representa un tipo de programación. Determina la frecuencia con la que Configuration Manager valida la integridad de los paquetes en el punto de distribución. Para crear un objeto de token de programación, use el cmdlet New-CMSchedule .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

IResultObject

IResultObject

IResultObject

IResultObject[]

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_SCI_SysResUse clase WMI de servidor.