Criar uma audiência para o SharePoint

APLICA-SE A:2013 2016 2019 Subscription Edition SharePoint no Microsoft 365

Saiba como usar um script do Windows PowerShell para criar uma audiência.

Criar uma audiência usando um script do Windows PowerShell

1. Verifique se você cumpre os requisitos mínimos a seguir:

• Confira Add-SPShellAdmin.

• Leia about_Execution_Policies.

2. Copie as seguintes declarações de variáveis e cole-as em um editor de texto, como o Bloco de Notas. Defina valores de entrada específicos para sua organização. Irá utilizar estes valores no passo 3. Salve o arquivo e dê a ele o nome de Audiences.ps1.

## Settings you may want to change for Audience Name and Description ## 
$mySiteHostUrl = https://www.my.contoso.com
$audienceName = "<Input name of audience>"
$audienceDescription = "<Input description for audience>"
$audienceRules = @()
$audienceRules += New-Object Microsoft.Office.Server.Audience.AudienceRuleComponent("AccountName", "Contains", "jdoe")
#Create an OR group operator between the two audience rules.
$audienceRules += New-Object Microsoft.Office.Server.Audience.AudienceRuleComponent("", "OR", "")
$audienceRules += New-Object Microsoft.Office.Server.Audience.AudienceRuleComponent("AccountName", "Contains", "jlew")

3. Copie o código a seguir e cole-o em Audiences.ps1, sob as declarações de variáveis da etapa 2.

#Get the My Site Host's SPSite object
$site = Get-SPSite $mySiteHostUrl
$ctx = [Microsoft.Office.Server.ServerContext]::GetContext($site)
$audMan = New-Object Microsoft.Office.Server.Audience.AudienceManager($ctx)
#Create a new audience object for the given Audience Manager
$aud = $audMan.Audiences.Create($audienceName, $audienceDescription)
$aud.AudienceRules = New-Object System.Collections.ArrayList
$audienceRules | ForEach-Object { $aud.AudienceRules.Add($_) }
#Save the new Audience
$aud.Commit()
#Compile the new Audience
$upa = Get-SPServiceApplication | Where-Object {$_.DisplayName -eq "User Profile Service Application"}
$audJob = [Microsoft.Office.Server.Audience.AudienceJob]::RunAudienceJob(($upa.Id.Guid.ToString(), "1", "1", $aud.AudienceName))

4. Clique no Shell de Gerenciamento do SharePoint

5. Altere para o diretório em que você salvou o arquivo.

6. No prompt de comando do PowerShell, digite o seguinte comando:

./Audiences.ps1 

Para obter informações adicionais sobre scripts do PowerShell e ficheiros .ps1, consulte Executar Scripts do Windows PowerShell.

Para obter mais informações sobre como criar audiências, consulte AudienceRuleComponent class (Classe AudienceRuleComponent).