New-SharingPolicy
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou 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 utilizadores só podem partilhar estas informações depois de a federação estar configurada no Exchange. Após a configuração da federação, os utilizadores podem enviar convites de partilha que estejam em conformidade com uma política de partilha para destinatários externos noutras organizações Exchange Server 2010 ou posteriores que tenham a federação ativada. 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 partilha fornecem a partilha de pessoas para pessoas estabelecida pelo utilizador, tanto do calendário como das informações de contacto, com diferentes tipos de utilizadores externos. As políticas de partilha permitem que os utilizadores partilhem as respetivas informações de livre/ocupado e de contacto (incluindo as pastas Calendário e Contactos) com destinatários noutras organizações federadas externas do Exchange. Para destinatários que não estejam numa organização federada externa ou que não estejam em organizações que não sejam do Exchange, as políticas de partilha permitem a partilha de informações do calendário entre pessoas com utilizadores anónimos através da utilização da Publicação de Calendários da Internet.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 Online
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, 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 confirmar 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 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 não for aplicada nenhuma política de partilha a uma caixa de correio, a política predefinida é 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
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 Online
O parâmetro Domains especifica os domínios e as opções de partilha associadas para esses domínios na política de partilha. Os valores para este parâmetro utilizam a sintaxe básica: 'Domain: SharingPolicyAction'.
Pode utilizar 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. - *: Partilhe com organizações federadas externas. Por exemplo, outra organização do Microsoft 365 ou uma organização do Exchange no local.
- Anónimo: partilhe com organizações externas e não federadas e indivíduos com acesso à Internet.
Pode utilizar os seguintes valores para SharingPolicyAction:
- CalendarSharingFreeBusySimple: Partilhar apenas horas de disponibilidade
- CalendarSharingFreeBusyDetail: Partilhar horas de disponibilidade, assunto e localização
- CalendarSharingFreeBusyReviewer: Partilhar horas de disponibilidade, assunto, localização e corpo da mensagem ou item de calendário
- ContactosSharing: partilhar apenas contactos
Pode especificar múltiplos 'Domain: SharingPolicyAction' valores separados por vírgulas e pode especificar múltiplos 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 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 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 Online
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.
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 suporta os 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.