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 ambiente ou de outro.
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 é configurada no Exchange. Após a configuração da federação, 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 do Exchange Server 2010 ou posteriores que tenham a federação habilitada. 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 o compartilhamento entre pessoas estabelecido pelo usuário de informações de calendário e contato com diferentes tipos de usuários externos. As políticas de compartilhamento permitem que os usuários compartilhem suas informações de disponibilidade 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 em organizações que não são do Exchange, as políticas de compartilhamento permitem o compartilhamento de pessoas para pessoas de suas informações de calendário com usuários anônimos por meio do uso da Internet Calendar Publishing.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
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 artigo 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 $true
Este 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Default
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 política de compartilhamento for aplicada a uma caixa de correio, a política padrão será aplicada automaticamente. Para desabilitar o compartilhamento em toda a organização, defina a diretiva padrão como desabilitada.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Domains
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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. - *: compartilhe 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 o horário de disponibilidade
- CalendarSharingFreeBusyDetail: Compartilhe o horário de disponibilidade, assunto e local
- CalendarSharingFreeBusyReviewer: Compartilhe o horário de disponibilidade, assunto, local e o corpo da mensagem ou item de calendário
- ContactsSharing: compartilhar somente contatos
Você pode especificar vários 'Domain: SharingPolicyAction' valores separados por vírgulas e pode especificar vários SharingPolicyAction valores para o mesmo domínio separados por vírgulas. Por exemplo, 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusyDetail, ContactsSharing'.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Enabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Name especifica o nome da nova diretiva de compartilhamento.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.