New-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 New-SharingPolicy para criar uma diretiva de compartilhamento para regular como os usuários dentro da organização poderão compartilhar informações de calendário e contato com usuários fora da organização. Os usuários só podem compartilhar essas informações depois que a federação tiver sido configurada no Exchange. Depois que a federação for configurada, os usuários poderão enviar convites de compartilhamento que estejam em conformidade com uma política de compartilhamento para destinatários externos em outras organizações Exchange Server 2010 ou posteriores habilitadas para federação. Uma diretiva de compartilhamento deve ser associada a uma caixa de correio para entrar em vigor. Se uma caixa de correio não tiver uma política de compartilhamento específica atribuída, uma política padrão irá impor o nível de compartilhamento permitido para essa caixa de correio.
As políticas de compartilhamento fornecem compartilhamento de pessoas para pessoas estabelecido pelo usuário de informações de calendário e contato com diferentes tipos de usuários externos. O compartilhamento de polícias permite que os usuários compartilhem suas informações gratuitas/ocupadas e contatos (incluindo as pastas Calendário e Contatos) com destinatários em outras organizações federadas externas do Exchange. Para destinatários que não estão em uma organização federada externa ou estão em organizações que não são do Exchange, o compartilhamento de políticas permite que as pessoas compartilhem suas informações de calendário com usuários anônimos por meio do uso da Publicação de Calendário da Internet.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-SharingPolicy
[-Name] <String>
-Domains <MultiValuedProperty>
[-Confirm]
[-Default]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
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
New-SharingPolicy -Name "Contoso" -Domains 'mail.contoso.com: CalendarSharingFreeBusyDetail, ContactsSharing'Este exemplo cria a diretiva de compartilhamento Contoso para o domínio contoso.com, que é um domínio fora da organização. Essa política permite que os usuários no domínio contoso.com vejam contatos e informações detalhadas de disponibilidade. Por padrão, essa diretiva está habilitada.
Exemplo 2
New-SharingPolicy -Name "SharingPolicy01" -Domains 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusySimple' -Enabled $false -Default $trueEste exemplo cria uma diretiva de compartilhamento padrão, que é aplicada a todas as caixas de correio às quais não foi atribuída implicitamente uma diretiva de compartilhamento. Essa diretiva de compartilhamento, SharingPolicy01, é aplicável a dois domínios diferentes e está desabilitada.
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 |
-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. Para desabilitar o compartilhamento em toda a organização, defina a diretiva padrão como desabilitada.
| 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 organização do Microsoft 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: | True |
| 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 a nova diretiva de compartilhamento estará habilitada. A entrada válida para esse parâmetro é $true ou $false. O padrão é $true.
Quando a diretiva de compartilhamento é desabilitada, os usuários configurados para usar essa diretiva continuam a compartilhar informações até que o assistente de diretiva de compartilhamento seja executado e remova as permissões da pasta compartilhada. A frequência de execução do assistente de diretiva de compartilhamento é atribuída no cmdlet Set-MailboxServer usando o parâmetro SharingPolicySchedule.
| 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 |
-Name
O parâmetro Name especifica o nome da nova diretiva de compartilhamento.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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 |
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.