Set-SPIRMSettings
Задает параметры управления правами на доступ к данным (IRM).
Синтаксис
Set-SPIRMSettings
-CertificateServerUrl <Uri>
[-IrmEnabled]
[-AssignmentCollection <SPAssignmentCollection>]
[-CertificatePassword <SecureString>]
[-Confirm]
[-ServiceAuthenticationCertificate <X509Certificate2>]
[-SubscriptionScopeSettingsEnabled]
[-WhatIf]
[-UseOauth]
[<CommonParameters>]Set-SPIRMSettings
[-IrmEnabled]
[-AssignmentCollection <SPAssignmentCollection>]
[-CertificatePassword <SecureString>]
[-Confirm]
[-ServiceAuthenticationCertificate <X509Certificate2>]
[-SubscriptionScopeSettingsEnabled]
[-UseActiveDirectoryDiscovery]
[-WhatIf]
[-UseOauth]
[<CommonParameters>]Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
Set-SPIRMSettings Используйте командлет , чтобы задать параметры управления правами на доступ к данным (IRM) для клиента.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
--------------ПРИМЕР 1------------
Set-SPIRMSettings -RmsEnabled -UseActiveDirectoryDiscoveryВ этом примере для фермы включается управление правами на доступ к данным, и настраивается использование сервера службы управления правами по умолчанию, настроенного в Active Directory.
--------------ПРИМЕР 2------------
Set-SPIRMSettings -RmsEnabled -CertificateServerUrl https://myrmsserverВ этом примере для фермы включается управление правами на доступ к данным, и задается URL-адрес используемого сервера службы управления правами.
--------------ПРИМЕР 3------------
site = Get-SPSite http://myspserver
$subscription = $site.SiteSubscription
Set-SPIRMSettings -SiteSubscription $subscription -RmsEnabled -CertificateServerUrl https://myrmsserverВ этом примере для указанного клиента включается управление правами на доступ к данным, и задается URL-адрес используемого сервера службы управления правами.
--------------ПРИМЕР 4------------
Set-SPIRMSettings -RmsEnabled:$falseВ этом примере для фермы отключается управление правами на доступ к данным.
Параметры
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-CertificatePassword
Задает пароль для доступа к сертификату проверки подлинности службы. Этот пароль необходим для установки сертификата в хранилище сертификатов компьютера.
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-CertificateServerUrl
Адрес сервера сертификации службы управления правами, который будет использоваться для клиента.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-IrmEnabled
Включает или отключает управление правами на доступ к данным для клиента.
Значение по умолчанию false.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ServiceAuthenticationCertificate
Сертификат проверки подлинности службы.
Если этот параметр задан и не имеет значение null, при подключении из этой фермы к серверу службы управления правами используется сертификат проверки подлинности. Если этот параметр не задан, при подключении локальной фермы к серверу службы управления правами используется встроенная проверка подлинности Windows.
| Type: | X509Certificate2 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SubscriptionScopeSettingsEnabled
Определяет возможность настройки управления правами на доступ к данным в области действия подписки на сайт.
Если управление правами на доступ к данным включено в области действия фермы, для подписок на сайты можно задавать только настраиваемые параметры управления.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UseActiveDirectoryDiscovery
Определяет возможность использования службы управления правами для определения адреса сервера этой службы в домене.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UseOauth
Определяет, следует ли использовать OAuth.
Допустимые значения: True и False.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |