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
- Verifique se você cumpre os requisitos mínimos a seguir:
Confira Add-SPShellAdmin.
Leia about_Execution_Policies.
- 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")
- 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))
Observação
Você pode usar outro nome de arquivo, mas precisa salvá-lo como um arquivo de texto codificado em ANSI, com a extensão .ps1.
Clique no Shell de Gerenciamento do SharePoint
Altere para o diretório em que você salvou o arquivo.
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).