Partilhar via


New-CMSecondarySite

SYNOPSIS

Criar um site secundário.

SYNTAX

NewDistributionPointByHTTPAndCreateCertificate (Padrão)

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

NewDistributionPointByHTTPSAndCreateCertificate

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

NewDistributionPointByHTTPSAndImportCertificate

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

NewDistributionPointByHTTPAndImportCertificate

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 local secundário. Para obter mais informações, consulte Prepare-se para instalar sites do Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Criar um site secundário

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

O segundo comando cria um site secundário chamado Sítio Remoto Contoso que tem o código de site CM2 no servidor denominado server2.corp.contoso.com. O comando especifica o SQL Server objeto de definições para o local secundário armazenado em $CIObj. O comando especifica o local primário para o local secundário que tem o código de 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

PARAMETERS

-AllowFallbackForContent

Indica se os clientes podem usar uma localização de fonte de retorno para o conteúdo.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Permitir a Colocação

Indica se o site secundário pode dar o seu melhor conteúdo.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Grupo de Fronteiras

Especifique uma variedade de objetos de grupo de fronteira para este sistema de site. Para obter este objeto, utilize o cmdlet Get-CMBoundaryGroup.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: BoundaryGroups

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CertificadoExpirationTimeUtc

Especifica a data e hora em que o certificado auto-assinado expira para um ponto de distribuição no local secundário.

Type: DateTime
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Password de CertificadoPassword

Especifica a palavra-passe para o certificado importado do PKI para o ponto de distribuição.

Type: SecureString
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- CertificatePath

Especifica a trajetória de importação do certificado emitido pelo PKI que o ponto de distribuição utiliza. Este parâmetro aplica-se quando o site secundário tiver instalado e configurado IIS para criar um ponto de distribuição.

Type: String
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClientConnectionType

Especifica o tipo de ligação ao cliente.

Type: ClientConnectionTypes
Parameter Sets: NewDistributionPointByHTTPSAndCreateCertificate, NewDistributionPointByHTTPSAndImportCertificate
Aliases:
Accepted values: Intranet, Internet, InternetAndIntranet

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ContentMonitoringPriority

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

Type: Priority
Parameter Sets: (All)
Aliases:
Accepted values: Lowest, Low, Medium, High, Highest

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CreateSelfSignedCertificate

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

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableAnonymous

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

Type: Boolean
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableBranchCache

Indica que os clientes que usam Windows BranchCache podem descarregar conteúdo a partir de um ponto de distribuição no local.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWhenDuplicateCertificate

Indica se o Gestor de Configuração substitui um certificado duplicado quando importa um certificado de cliente PKI para o site secundário.

Type: Boolean
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Http

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

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Https

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

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndCreateCertificate, NewDistributionPointByHTTPSAndImportCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ImportCertificato

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

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Instalar oInternetServer

Especifica se deve instalar e configurar o IIS se o Gestor de Configuração o exigir. Este parâmetro deve ser $True antes do cmdlet instalar a função do sistema de instalação para o ponto de distribuição no local secundário.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Grupo de instalação

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

Type: String
Parameter Sets: (All)
Aliases: InstallDir

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstallationSourceFile

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

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MinFreeSpaceMB

Especifica a quantidade de espaço, em megabytes, para reservar em cada unidade que o ponto de distribuição utiliza. Este valor determina o espaço livre restante na unidade após o conteúdo das lojas de distribuição na unidade.

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

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrimaryContentLibraryLocation

Especifica a localização da biblioteca de conteúdo primário.

Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: 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

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrimaryPackageShareLocation

Especifica uma localização de partilha de pacote primário.

Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: 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

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Código PrimarySite

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

Type: String
Parameter Sets: (All)
Aliases: ParentSiteCode

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SecondaryContentLibraryLocation

Especifica a localização da biblioteca de conteúdo secundário.

Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: 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

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SecondaryPackageShareLocation

Especifica uma localização de partilha de pacotes secundários.

Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: 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

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Código Secundário

Especifique um código de site único de três caracteres para o site secundário.

Type: String
Parameter Sets: (All)
Aliases: SiteCode

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Nome do servidor

Especifique o nome de domínio totalmente qualificado (FQDN) do servidor para usar como servidor de site secundário.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SiteName

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

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SqlServerSetting

Especifica um conjunto de SQL Server objeto de definições no Gestor de Configurações. Para obter este objeto, utilize o cmdlet New-CMSqlServerSetting.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ValidarContentSchedule

Especifica um objeto que representa um tipo de programação. Determina a frequência com que o Gestor de Configuração valida a integridade dos pacotes no ponto de distribuição. Para criar um objeto simbólico de programação, utilize o cmdlet New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject#SMS_Site

IResultObject#SMS_SCI_SiteDefinition

IResultObject#SMS_SCI_SysResUse

IResultObject[]#SMS_SCI_Address

NOTAS

Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_SCI_SysResUse classe WMI do servidor.

New-CMInstallationSourceFile

New-CMSqlServerSetting

Remover-CMSecondarySite