New-SPManagedPath

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Cria um novo caminho gerenciado para o aplicativo Web determinado de todos os conjuntos de sites de cabeçalho de host.

Syntax

New-SPManagedPath
   [-RelativeURL] <String>
   [-HostHeader]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Explicit]
   [-WhatIf]
   [<CommonParameters>]

New-SPManagedPath
   [-RelativeURL] <String>
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Explicit]
   [-WhatIf]
   [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O New-SPManagedPath cmdlet adiciona um novo caminho gerenciado a um determinado aplicativo Web ou para uso com todas as coleções de sites de cabeçalho do host. Se a opção HostHeader for fornecida, o caminho gerenciado será compartilhado entre todas as coleções de sites nomeadas pelo host; caso contrário, um aplicativo Web deve ser especificado para criar esse caminho gerenciado dentro. A URL relativa é uma URL parcial que representa o caminho gerenciado. Quando a marca de barra (/) é usada, a raiz é definida. Se o parâmetro Explicit não for fornecido, o novo caminho gerenciado será um caminho curinga.

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

New-SPManagedPath "Teams" -WebApplication "https://somesite"

Este exemplo cria um caminho gerenciado do Teams para um determinado aplicativo Web (https://somesite).

Parâmetros

-AssignmentCollection

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.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Explicit

Especifica se o caminho gerenciado será explícito ou curinga.

Se não for fornecido, o caminho gerenciado será um caminho curinga.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-HostHeader

Se este parâmetro for fornecido, esse caminho gerenciado se aplicará a todos os conjuntos de sites de cabeçalho de host.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-RelativeURL

Especifica a URL relativa do novo caminho gerenciado.

O tipo deve ser uma URL parcial válida como, por exemplo, site ou sites/teams/.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

Especifica o grupo de aplicativo Web para ser adicionado a esse caminho.

O tipo deve ser uma URL válida no formato https://server_name ou um GUID no formato 1234-5678-0987645a.

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition