Get-CsPrivacyConfiguration
Tópico modificado em: 2012-03-23
Retorna informações sobre as definições de configuração de privacidade em uso na organização. As definições de configuração de privacidade ajudam a determinar quanta informação os usuários tornam disponível a outros usuários.
Sintaxe
Get-CsPrivacyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPrivacyConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Descrição Detalhada
O Microsoft Lync Server 2010 fornece aos usuários a oportunidade de compartilhar uma gama de informações de presença com outras pessoas: elas podem publicar uma fotografia de si mesmas, fornecer informações de localização detalhada, disponibilizar automaticamente informações de presença a todas as pessoas da organização (em vez de disponibilizá-las apenas a pessoas de sua lista de Contatos).
Alguns usuários acolherão a oportunidade de disponibilizar estas informações a seus colegas; é possível que outros usuários sejam mais relutantes em compartilhar esses dados (por exemplo, muitas pessoas poderão hesitar em incluir suas fotos nos seus dados de presença). Como regra geral, os usuários têm controle sobre as informações que eles compartilharão (ou não). Por exemplo, os usuários podem marcar ou desmarcar uma caixa de seleção, controlando se as suas informações de local serão compartilhadas ou não com outras pessoas. Além disso, os cmdlets de configuração de privacidade (Get-CsPrivacyConfiguration, Set-CsPrivacyConfiguration, New-CsPrivacyConfiguration e Remove-CsPrivacyConfiguration) permitem aos administradores gerenciar as definições de privacidade dos seus usuários. Em alguns casos, os administradores podem habilitar ou desabilitar definições; por exemplo, se a propriedade AutoInitiateContacts for definida como True, os integrantes da equipe serão adicionados automaticamente à lista de contatos de cada usuário; se ela for definida como False, os integrantes da equipe não serão adicionados automaticamente à lista de contatos de cada usuário.
Em outros casos, os administradores podem configurar os valores padrão no Lync Server 2010, continuando a permitir que os usuários alterem esses valores. Por exemplo, por padrão, publicam-se os dados de localização dos usuários, apesar de eles terem o direito de interromper a sua publicação. Ao definir a propriedade PublishLocationDataByDefault como sendo False, os administradores podem alterar esse comportamento: neste caso, os dados de localização não serão publicados por padrão, apesar de os usuários ainda terem o direito de publicar esses dados, se assim optarem.
As definições de configuração de privacidade podem ser aplicadas no escopo global, escopo do site e no escopo de serviço (embora apenas para o serviço Servidor de Usuários). O cmdlet Get-CsPrivacyConfiguration permite recuperar informações sobre todas as definições de configuração de privacidade em uso na organização.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsPrivacyConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPrivacyConfiguration"}
Parâmetros
Parâmetro | Obrigatório | Digite | Descrição |
---|---|---|---|
Identity |
Opcional |
Identidade de Xds |
Identificador exclusivo das definições de configuração de privacidade a serem recuperadas. Para retornar as definições globais, use essa sintaxe: -Identity global. Para retornar definições configuradas no escopo de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Para modificar as definições no nível de serviço, utilize uma sintaxe como esta: -Identity service:UserServer:atl-cs-001.litwareinc.com Se esse parâmetro não for especificado, Get-CsPrivacyConfiguration retornará todas as definições de configuração de privacidade em uso na organização. |
Filter |
Opcional |
Cadeia de caracteres |
Permite utilizar caracteres curingas para retornar uma ou várias coleções de definições de configuração de privacidade. Por exemplo, para retornar todas as definições configuradas no escopo de site, utilize essa sintaxe: -Filter "site:*" Para retornar todas as definições configuradas no escopo de serviço, utilize essa sintaxe: -Filter "service:*". |
Tenant |
Opcional |
GUID |
Esse parâmetro não é usado com a versão local de Lync Server 2010. |
LocalStore |
Opcional |
Parâmetro de opção |
Recupera os dados de configuração de privacidade na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma. Get-CsPrivacyConfiguration não aceita a entrada canalizada.
Tipos de Retorno
Get-CsPrivacyConfiguration retorna instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.PrivacyConfiguration.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsPrivacyConfiguration
O comando exibido no Exemplo 1 retorna todas as definições de configuração de privacidade em uso na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsPrivacyConfiguration -Identity site:Redmond
O comando anterior retorna uma única coleção de definições de configuração de privacidade: as definições cuja Identidade for site:Redmond.
-------------------------- Exemplo 3 ------------------------
Get-CsPrivacyConfiguration -Filter "site:*"
No Exemplo 3, retornam-se informações sobre todas as definições de configuração de privacidade que tiverem sido atribuídas no escopo de site. Para isso, inclui-se o parâmetro Filter, juntamente com o valor de filtro "site:*". Esse valor de filtro garante que apenas as definições cuja Identidade (a única propriedade que se pode filtrar) começar com os caracteres "site:".
-------------------------- Exemplo 4 ------------------------
Get-CsPrivacyConfiguration | Where-Object {$_.EnablePrivacyMode -eq $True}
O comando exibido no Exemplo 4 retorna informações sobre todas as definições de configuração de privacidade nas quais o modo privacidade tiver sido habilitado. Isso é feito chamando-se primeiramente Get-CsPrivacyConfiguration, sem qualquer parâmetro, para retornar uma coleção de todas as definições de privacidade. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade EnablePrivacyMode for igual a True.
Consulte Também
Outros Recursos
New-CsPrivacyConfiguration
Remove-CsPrivacyConfiguration
Set-CsPrivacyConfiguration