Set-SPIRMSettings

  • Referência
Módulo:
sharepoint-server
Aplica-se a:
SharePoint Server Subscription Edition

Define as configurações do Gerenciamento de Direitos de Informação (IRM).

Syntax

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

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.

Use o Set-SPIRMSettings cmdlet para definir as configurações do IRM (Information Rights Management) para o locatário.

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

Set-SPIRMSettings -RmsEnabled -UseActiveDirectoryDiscovery

Este exemplo habilita o IRM para o farm e o configura para usar o servidor RMS padrão configurado no Active Directory.

--------------EXEMPLO 2------------

Set-SPIRMSettings -RmsEnabled -CertificateServerUrl https://myrmsserver

Este exemplo habilita o IRM para o farm e especifica o URL para o servidor RMS usar.

--------------EXEMPLO 3------------

site = Get-SPSite http://myspserver
$subscription = $site.SiteSubscription
Set-SPIRMSettings -SiteSubscription $subscription -RmsEnabled -CertificateServerUrl https://myrmsserver

Este exemplo habilita o IRM para o inquilino especificado e especifica o URL para o servidor RMS usar.

--------------EXEMPLO 4------------

Set-SPIRMSettings -RmsEnabled:$false

Este exemplo desabilita o IRM do farm.

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

-CertificatePassword

Especifica a senha para acessar o Certificado de Autenticação de Serviço. Esta é necessária para instalar o certificado no repositório de certificados do computador.

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

-CertificateServerUrl

Especifica o endereço do servidor de certificado RMS para uso do inquilino.

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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

-IrmEnabled

Especifica se o IRM é ou não habilitado no inquilino.

O valor padrão é falso.

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

-ServiceAuthenticationCertificate

Especifica o certificado de autenticação de serviço.

Se o parâmetro é especificado e não nulo, o certificado de autenticação é usado quando conectar este farm para o servidor RMS. Se o parâmetro não é especificado, o farm local conecta-se ao servidor RMS usando a autenticação do Windows integrada.

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

-SubscriptionScopeSettingsEnabled

Especifica se o IRM pode ou não ser configurado no escopo de assinatura do site.

As assinaturas do site podem apenas definir as configurações IRM personalizadas, se o IRM é habilitado no escopo do farm.

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

-UseActiveDirectoryDiscovery

Especifica se o serviço RMS deve ou não ser usado para descoberta que determinará o endereço do servidor RMS no domínio.

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

-UseOauth

Especifica se o OAuth deve ser usado.

Os valores válidos são True e False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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