New-CMSecondarySite

Referência

Módulo:: ConfigurationManager

Criar um site secundário.

Sintaxe

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

O cmdlet New-CMSecondarySite cria um site secundário. Para obter mais informações, veja Preparar a instalação de sites do Configuration Manager.

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: Criar um site secundário

Este primeiro comando cria um objeto de definições do SQL Server. Este objeto especifica que o Microsoft SQL Server Express é copiado para um site secundário do Configuration Manager. O comando armazena o objeto na variável $CIObj .

O segundo comando cria um site secundário chamado Site remoto da Contoso que tem o código do site CM2 no servidor com o nome server2.corp.contoso.com. O comando especifica o objeto de definições do SQL Server para o site secundário armazenado no $CIObj. O comando especifica o site primário do site secundário que tem o código do site 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 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 site secundário pode pré-configurar conteúdo.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BoundaryGroup

Especifique uma matriz de objetos de grupo de limites para este sistema de sites. Para obter este objeto, utilize o cmdlet Get-CMBoundaryGroup .

Tipo:	IResultObject[]
Aliases:	BoundaryGroups
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 autoassinado expira para um ponto de distribuição no site secundário.

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 do certificado importado PKI para o ponto de distribuição.

Tipo:	SecureString
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
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. Este parâmetro aplica-se quando o site secundário tiver instalado e configurado o IIS para criar um ponto de distribuição.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClientConnectionType

Especifica o tipo de ligação de cliente.

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

-ContentMonitoringPriority

Especifica a prioridade de monitorização de conteúdos.

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

-CreateSelfSignedCertificate

Indica que o site secundário cria um certificado autoassinado para o ponto de distribuição.

Tipo:	SwitchParameter
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 os computadores cliente comunicam anonimamente com o ponto de distribuição. Este parâmetro aplica-se quando o site secundário tiver instalado e configurado o IIS para criar um 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

-EnableBranchCache

Indica que os clientes que utilizam o Windows BranchCache têm permissão para transferir conteúdos a partir de um ponto de distribuição no local.

Tipo:	SwitchParameter
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 site secundário.

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

-Http

Indica que os computadores cliente comunicam com o ponto de distribuição através de HTTP. Este parâmetro aplica-se quando o site secundário tiver instalado e configurado o IIS para criar um ponto de distribuição. \

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Https

Indica que os computadores cliente comunicam com o ponto de distribuição através de HTTPS. Este parâmetro aplica-se quando o site secundário tiver instalado e configurado o IIS para criar um ponto de distribuição.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ImportCertificate

Indica que o cmdlet importa um certificado PKI em vez de utilizar um certificado autoassinado para o ponto de distribuição.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InstallationFolder

Especifica a pasta de instalação no servidor do site secundário onde o cmdlet instala os ficheiros do site.

Tipo:	String
Aliases:	InstallDir
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InstallationSourceFile

Especifica uma matriz de objetos de ficheiro de origem de instalação para o Configuration Manager. Para obter este objeto, utilize o cmdlet New-CMInstallationSourceFile .

Tipo:	IResultObject[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InstallInternetServer

Especifica se pretende instalar e configurar o IIS se o Configuration Manager o exigir. Este parâmetro tem de ser $True antes de o cmdlet instalar a função do sistema de sites para o ponto de distribuição no site secundário.

Tipo:	Boolean
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, em megabytes, a reservar em cada unidade que o ponto de distribuição utiliza. Este valor determina o espaço livre restante na unidade após a distribuição armazenar o conteúdo na unidade.

A partir da versão 2107, o espaço livre mínimo predefinido mudou de 200 MB para 500 MB.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PrimaryContentLibraryLocation

Especifica uma localização da biblioteca de conteúdos principal.

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 uma localização de partilha de pacote principal.

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

-PrimarySiteCode

Especifique o código de site de três carateres do site principal.

Tipo:	String
Aliases:	ParentSiteCode
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SecondaryContentLibraryLocation

Especifica uma localização secundária da biblioteca de conteúdos.

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 uma localização de partilha de pacote secundária.

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

-SecondarySiteCode

Especifique um código de site de três carateres exclusivo para o site secundário.

Tipo:	String
Aliases:	SiteCode
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServerName

Especifique o nome de domínio completamente qualificado (FQDN) do servidor a utilizar como servidor de site secundário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SiteName

Especifica o nome do site que ajuda a identificar o site secundário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SqlServerSetting

Especifica uma matriz do objeto de definições do SQL Server no Configuration Manager. Para obter este objeto, utilize o cmdlet New-CMSqlServerSetting .

Tipo:	IResultObject[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ValidateContentSchedule

Especifica um objeto que representa um tipo de agenda. Determina a frequência com que o Configuration Manager valida a integridade dos pacotes no ponto de distribuição. Para criar um objeto de token de agendamento, 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

None

Saídas

IResultObject

IResultObject[]

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_SCI_SysResUse classe WMI de servidor.

Compartilhar via