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.