New-SPSite
Cria um novo conjunto de sites na URL especificada.
Sintaxe
Default (Padrão)
New-SPSite
[-Url] <String>
-OwnerAlias <SPUserPipeBind>
[-AdministrationSiteType <SPAdministrationSiteType>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CompatibilityLevel <Int32>]
[-Confirm]
[-ContentDatabase <SPContentDatabasePipeBind>]
[-Description <String>]
[-HostHeaderWebApplication <SPWebApplicationPipeBind>]
[-Language <UInt32>]
[-Name <String>]
[-OverrideCompatibilityRestriction]
[-OwnerEmail <String>]
[-QuotaTemplate <SPQuotaTemplatePipeBind>]
[-SecondaryEmail <String>]
[-SecondaryOwnerAlias <SPUserPipeBind>]
[-SiteSubscription <SPSiteSubscriptionPipeBind>]
[-Template <SPWebTemplatePipeBind>]
[-WhatIf]
[-CreateFromSiteMaster]
[<CommonParameters>]
Description
O New-SPSite cmdlet cria uma nova coleção de sites com o URL e o proprietário que os parâmetros URL e OwnerAlias.
Este cmdlet pode criar coleções de sites no modo sharePoint Server que utiliza as versões legadas de modelos e funcionalidades ou pode ser criado no modo do SharePoint Server que utiliza as novas versões de modelos e funcionalidades.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
EXEMPLO 1
New-SPSite https://webApp/sites/test -OwnerAlias "DOMAIN\JDoe" -Language 1033 -Template STS#0
Este exemplo cria uma coleção de sites em inglês em https://< site name>/sites/test que pertence ao utilizador DOMAIN\Jdow.
EXEMPLO 2
$w = Get-SPWebApplication https://webApp
New-SPSite https://www.contoso.com -OwnerAlias "DOMAIN\jdow" -HostHeaderWebApplication $w -Name "Contoso" -Template STS#0
Este exemplo cria uma coleção de sites com o nome de anfitrião. Como o modelo é fornecido, a Web raiz desse conjunto de sites será criada.
EXEMPLO 3
Get-SPWebTemplate | Where{ $_.Title -eq "Team Site" } | ForEach-Object{ New-SPSite https://<site name</sites/test -OwnerAlias DOMAIN\jdow -Template $_ }
Este exemplo cria um conjunto de sites usando o modelo da Web "Team Site".
EXEMPLO 4
New-SPSite -URL https://webApp/sites/testsite -OwnerAlias "DOMAIN\JDow" -Language 1033 -CompatibilityLevel 14 -Template STS#0
Este exemplo cria uma coleção de sites no modo inglês 14 ao utilizar o modelo site de equipa em https://< site name>/sites/testsite que pertence ao utilizador DOMAIN\Jdow
Parâmetros
-AdministrationSiteType
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o tipo de site.
Os valores válidos são None ou TentantAdministration.
Propriedades do parâmetro
| Tipo: | SPAdministrationSiteType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AssignmentCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CompatibilityLevel
Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019
Especifica a versão dos modelos a serem usados ao criar um novo objeto SPSite.
Este valor define o valor CompatibilityLevel inicial para o conjunto de sites.
Quando este parâmetro não é especificado, o CompatibilityLevel será padrão para a maior versão possível do aplicativo Web dependendo da configuração SiteCreationMode.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ContentDatabase
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o nome ou o GUID do banco de dados de conteúdo no qual criar o novo site. Se nenhum banco de dados de conteúdo for especificado, o conjunto de sites será selecionado automaticamente.
O tipo deve ser um nome de banco de dados válido, no formato SiteContent1212, ou um GUID, no formato 1234-5678-9807.
Propriedades do parâmetro
| Tipo: | SPContentDatabasePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CreateFromSiteMaster
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Especifica se um novo site deve ser criando usando o Site Mestre.
Os valores válidos são True ou False.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Description
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Descreve o novo site.
Se nenhum valor for especificado, o valor será deixado em branco.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-HostHeaderWebApplication
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica que, se o URL fornecido for uma coleção de sites com o nome de anfitrião, o parâmetro HostHeaderWebApplication tem de ser o nome, URL, GUID ou objeto SPWebApplication para a aplicação Web na qual esta coleção de sites é criada.
Se nenhum valor for especificado, o valor será deixado em branco.
O tipo deve ser um nome válido em um dos seguintes formatos:
--A WebApplication
--Um URL (por exemplo, https://server_name)
--Um GUID (por exemplo, 1234-5678-9876-0987)
Propriedades do parâmetro
| Tipo: | SPWebApplicationPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Language
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica a ID do idioma para o novo conjunto de sites.
Se nenhum idioma for especificado, o conjunto de sites será criado com o mesmo idioma que foi especificado quando o produto foi instalado.
Deve ser um LCID (identificador de idioma) válido.
Propriedades do parâmetro
| Tipo: | UInt32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o título do novo conjunto de sites.
Se nenhum nome for especificado, será aplicado o nome padrão.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OverrideCompatibilityRestriction
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica se a restrição de compatibilidade deve ser usada para o site.
Os valores válidos são True ou False.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OwnerAlias
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o nome de login de usuário do proprietário do site.
O tipo deve ser um alias de usuário válido, no formato Domínio\nome_de_usuário.
Propriedades do parâmetro
| Tipo: | SPUserPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OwnerEmail
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o endereço de email do proprietário do site. Se nenhum valor for especificado, o valor será deixado em branco.
O tipo tem de ser um endereço de e-mail no formulário , someone@example.com.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-QuotaTemplate
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o modelo de quota para o novo site. O modelo já tem de existir.
Se nenhum modelo for especificado, nenhuma cota será aplicada.
Propriedades do parâmetro
| Tipo: | SPQuotaTemplatePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SecondaryEmail
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o endereço de email do proprietário do site secundário. Se nenhum valor for especificado, o valor será deixado em branco.
O tipo tem de ser um endereço de e-mail, no formulário , someone@example.com.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SecondaryOwnerAlias
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica as credenciais de login do usuário do proprietário do site secundário.
Se nenhum valor for especificado, o valor será deixado em branco.
O tipo deve ser um alias usuário válido, no formato Domínio\nome_de_usuário.
Propriedades do parâmetro
| Tipo: | SPUserPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SiteSubscription
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o Grupo de Sites que receberá os conjuntos de sites.
Propriedades do parâmetro
| Tipo: | SPSiteSubscriptionPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Template
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o modelo da Web para a Web raiz do novo conjunto de sites.
O modelo já deve estar instalado.
Se nenhum modelo for especificado, nenhum modelo será provisionado.
Propriedades do parâmetro
| Tipo: | SPWebTemplatePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Url
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o URL usado pelo novo conjunto de sites.
Se o URL não for um site de cabeçalho de anfitrião, o URL tem de começar com o URL da aplicação Web.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.