Set-SharingPolicy
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet Set-SharingPolicy para modificar políticas de compartilhamento existentes que controlam como os usuários dentro da organização podem compartilhar informações de disponibilidade e informações de contato com usuários fora da sua organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Set-SharingPolicy
[-Identity] <SharingPolicyIdParameter>
[-Confirm]
[-Default]
[-DomainController <Fqdn>]
[-Domains <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>] Description
Os usuários só podem compartilhar informações gratuitas/ocupadas e entrar em contato depois que a federação tiver sido configurada entre organizações do Exchange. Depois disso, os usuários podem enviar convites de compartilhamento para destinatários externos, desde que esses convites estejam de acordo com a política de compartilhamento. Uma política de compartilhamento precisa ser atribuída a uma caixa de correio para ser eficaz. Se uma caixa de correio não tiver uma política de compartilhamento específica atribuída, uma política padrão imporá as opções de compartilhamento para a caixa de correio.
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-SharingPolicy -Identity Contoso -Domains "mail.contoso.com: CalendarSharingFreeBusySimple"Este exemplo modifica a diretiva de compartilhamento Contoso em contoso.com, que é um domínio externo à organização. Essa diretiva permite aos usuários no domínio Contoso exibir informações simples de disponibilidade.
Exemplo 2
Set-SharingPolicy -Identity SharingPolicy01 -Domains "contoso.com: CalendarSharingFreeBusySimple", "atlanta.contoso.com: CalendarSharingFreeBusyReviewer", "beijing.contoso.com: CalendarSharingFreeBusyReviewer"Este exemplo adiciona um segundo domínio à diretiva de compartilhamento SharingPolicy01. Ao adicionar um domínio a uma diretiva existente, inclua quaisquer domínios incluídos previamente.
Exemplo 3
Set-SharingPolicy -Identity "SharingPolicy01" -Enabled $falseEste exemplo desabilita a diretiva de compartilhamento SharingPolicy01.
Parâmetros
-Confirm
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Default
A opção Default especifica que essa política de compartilhamento é a padrão para todas as caixas de correio. Não é preciso especificar um valor com essa opção.
Se nenhuma diretiva de compartilhamento tiver sido aplicada a uma caixa de correio, a diretiva padrão será aplicada automaticamente. Se quiser desabilitar o compartilhamento em sua organização, você pode desabilitar a política padrão.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Domains
O parâmetro Domains especifica os domínios e as opções de compartilhamento associadas para esses domínios na política de compartilhamento. Os valores para este parâmetro usam a sintaxe básica: 'Domain: SharingPolicyAction'.
Você pode usar os seguintes valores para Domain:
- Um domínio: por exemplo,
mail.contoso.com. Um domínio não inclui subdomínios. Você deve configurar cada subdomínio separadamente. - *: Compartilhar com organizações federadas externas. Por exemplo, outra Microsoft organização 365 ou uma organização local do Exchange.
- Anônimo: compartilhe com organizações externas, não federadas e indivíduos com acesso à Internet.
Você pode usar os seguintes valores para SharingPolicyAction:
- CalendarSharingFreeBusySimple: compartilhar somente horas livres/ocupadas
- CalendarSharingFreeBusyDetail: Compartilhar horas livres/ocupadas, assunto e localização
- CalendarSharingFreeBusyReviewer: Compartilhar horas gratuitas/ocupadas, assunto, local e o corpo da mensagem ou item do calendário
- ContactsSharing: somente compartilhar contatos
Você pode especificar vários 'Domain: SharingPolicyAction' valores separados por vírgulas e especificar vários SharingPolicyAction valores para o mesmo domínio separado por vírgulas. Por exemplo, 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusyDetail, ContactsSharing'.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Enabled
O parâmetro Enabled especifica se deve-se habilitar a diretiva de compartilhamento. Os valores válidos para esse parâmetro são $true ou $false. O padrão é $true.
Quando a diretiva de compartilhamento é desabilitada, os usuários provisionados para uso da diretiva continuam compartilhando informações até que o assistente de diretiva de compartilhamento seja executado.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
O parâmetro Identity especifica a identidade da diretiva de compartilhamento a ser modificada. Você pode usar um dos seguintes valores:
- ADObjectID
- Nome diferenciado (DN)
- DN Herdado
- GUID
| Type: | SharingPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
O parâmetro Name especifica o nome exclusivo da política de compartilhamento. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.