Set-SPPassPhrase
Задает новое значение для фразы-пароля.
Синтаксис
Set-SPPassPhrase
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-LocalServerOnly]
[-WhatIf]
-PassPhrase <SecureString>
[<CommonParameters>]
Set-SPPassPhrase
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
-ConfirmPassPhrase <SecureString>
-PassPhrase <SecureString>
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Командлет Set-SPPassPhrase
задает для парольной фразы новое значение Passphrase.
Если параметр LocalServerOnly не используется, ключ шифрования фермы повторно шифруется с новым значением и пытается распространить это значение на все остальные серверы фермы.
Если используется параметр LocalServerOnly, он обновляется только на локальном компьютере, а ключ шифрования фермы не изменяется.
Значение парольной фразы должно быть одинаковым на всех серверах фермы, если ферма должна работать правильно.
Таким образом, если парольная фраза не распространяется на все серверы, параметр LocalServerOnly можно использовать, чтобы задать для остальных серверов новое значение парольной фразы вручную.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
------------------ПРИМЕР-----------------------
$passphrase = ConvertTo-SecureString -asPlainText -Force
Set-SPPassPhrase -PassPhrase $passphrase -Confirm
В этом примере запрашивается строка, используемая в качестве парольной фразы, и в качестве парольной фразы фермы устанавливается новое значение.
Параметры
-AssignmentCollection
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
При использовании параметра Global все объекты содержатся в глобальном хранилище.
Если объекты не используются сразу или удаляются с помощью команды Stop-SPAssignment
, может возникнуть нехватка памяти.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Confirm
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: 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 |
-ConfirmPassPhrase
Парольную фразу необходимо вводить дважды, чтобы подтвердить корректность первой записи.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-LocalServerOnly
Изменяет параметр Passphrase только на локальном сервере. Если этот параметр не используется, изменение выполняется на всей ферме.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-PassPhrase
Указывает новое значение параметра Passphrase.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: 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 |