Поделиться через


Remove-SPManagedPath

Удаляет заданный управляемый путь из заданного заголовка узла или веб-приложения.

Синтаксис

HostHeader

Remove-SPManagedPath
    [-Identity] <SPPrefixPipeBind>
    [-HostHeader]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

WebApplication

Remove-SPManagedPath
    [-Identity] <SPPrefixPipeBind>
    -WebApplication <SPWebApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Командлет Remove-SPManagedPath удаляет управляемый путь, указанный параметром Identity, из заголовка узла или веб-приложения. Параметр Identity должен быть представлен в виде сокращенного URL-адреса управляемого пути, который необходимо удалить.

Если вы используете семейства веб-сайтов с именем узла, укажите параметр HostHeader. Чтобы удалить управляемый путь семейства веб-сайтов с именем узла, укажите параметр HostHeader. В противном случае необходимо указать веб-приложение, содержащее управляемый путь, который требуется удалить.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

ПРИМЕР 1

Remove-SPManagedPath "sites" -HostHeader

В этом примере управляемый путь к сайтам удаляется из списка управляемых путей семейства веб-сайтов с именем узла.

В зависимости от уровня подтверждения на локальной системе предшествующий пример кода может выдать запрос на подтверждение, прежде чем начать выполнение.

ПРИМЕР 2

Get-SPWebApplication | Remove-SPManagedPath "personal" -confirm:$false

В данном примере кода удаляется управляемый путь personal из всех веб-приложений на ферме. Эта команда не выводит запрос на подтверждение.

Параметры

-AssignmentCollection

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

При использовании параметра Global все объекты содержатся в глобальном хранилище. Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment, может возникнуть нехватка памяти.

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-HostHeader

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает, что параметр Identity является управляемым путем заголовка узла.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

HostHeader
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает имя управляемого пути, который необходимо удалить. Например, в URL-адресе http://имя_сайта/sites/site1 именем управляемого пути является "sites".

Свойства параметра

Тип:SPPrefixPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WebApplication

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает идентификатор веб-приложения, содержащий управляемый путь, который необходимо удалить. Типом должен быть действительный идентификатор GUID в формате 12345678-90ab-cdef-1234-567890bcdefgh, действительное имя веб-приложения (например, WebApplication1212) или действительное имя в формате WebApp2423.

Свойства параметра

Тип:SPWebApplicationPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

WebApplication
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.