Set-MailboxCalendarFolder
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 Set-MailboxCalendarFolder para configurar a publicação do calendário ou as configurações de compartilhamento de uma caixa de correio para a visibilidade das informações de calendário para usuários externos. Para adicionar ou modificar as permissões para que usuários internos possam acessar o calendário, use os cmdlets Add-MailboxFolderPermission ou Set-MailboxFolderPermission.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-MailboxCalendarFolder
[-Identity] <MailboxFolderIdParameter>
[-Confirm]
[-DetailLevel <DetailLevelEnumType>]
[-DomainController <Fqdn>]
[-PublishDateRangeFrom <DateRangeEnumType>]
[-PublishDateRangeTo <DateRangeEnumType>]
[-PublishEnabled <Boolean>]
[-ResetUrl]
[-SearchableUrlEnabled <Boolean>]
[-SetAsSharingSource]
[-SharedCalendarSyncStartDate <DateTime>]
[-UseHttps]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Set-MailboxCalendarFolder configura as informações de publicação do calendário. A pasta do calendário pode ser configurada da seguinte forma:
- Se a pasta do calendário estiver habilitada para publicação
- Intervalo de dias do calendário inicial e final para publicação
- Nível de detalhes para publicação do calendário
- Se a URL publicada do calendário está habilitada para pesquisa na Web
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
Set-MailboxCalendarFolder -Identity kai:\Calendar -DetailLevel LimitedDetails
Este exemplo define o nível de detalhes a serem publicados para o calendário compartilhado de Kai como LimitedDetails, o que significa a exibição dos detalhes limitados.
Exemplo 2
Set-MailboxCalendarFolder -Identity kai:\Calendar -SearchableUrlEnabled $true
Este exemplo habilita o calendário na caixa de correio de Kai a ser pesquisada na Web.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
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 |
-DetailLevel
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro DetailLevel especifica o nível de detalhes do calendário publicado e disponível para usuários anônimos. Os valores válidos são:
- AvailabilityOnly (padrão)
- Detalhes Limitados
- Detalhes completos
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | DetailLevelEnumType |
| 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 |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
O parâmetro Identity especifica a pasta de calendário que você deseja modificar. A sintaxe é MailboxID:\ParentFolder[\SubFolder].
Para o valor de , você pode usar qualquer valor que identifique exclusivamente a caixa de MailboxIDcorreio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Os valores de exemplo para este parâmetro são john@contoso.com:\Calendar ou John:\Calendar
Propriedades do parâmetro
| Tipo: | MailboxFolderIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PublishDateRangeFrom
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro PublishDateRangeFrom especifica a data de início das informações do calendário a serem publicadas (informações anteriores). Os valores válidos são:
- Um dia
- Três dias
- Uma semana
- Um mês
- Três Meses (valor padrão)
- SixMonths
- Um ano
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | DateRangeEnumType |
| 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 |
-PublishDateRangeTo
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro PublishDateRangeTo especifica a data de término das informações de calendário a serem publicadas (informações futuras). Os valores válidos são:
- Um dia
- Três dias
- Uma semana
- Um mês
- Três Meses (valor padrão)
- SixMonths
- Um ano
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | DateRangeEnumType |
| 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 |
-PublishEnabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro PublishEnabled especifica se as informações de calendário especificadas devem ser publicadas. Os valores válidos são:
- $true: As informações do calendário são publicadas.
- $false: As informações do calendário não são publicadas. Esse valor é o padrão.
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 |
-ResetUrl
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção ResetUrl substitui a URL não pública existente por uma nova URL para um calendário que é publicado sem ser pesquisável publicamente. 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 |
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 |
-SearchableUrlEnabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro SearchableUrlEnabled especifica se a URL do calendário publicado é detectável na Web.
- $true: A URL do calendário publicado é detectável na Web.
- $false: A URL do calendário publicado não é detectável na Web. Esse valor é o padrão.
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
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 |
-SetAsSharingSource
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção SetAsSharingSource especifica se a pasta de calendário deve ser definida como uma fonte de compartilhamento. 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 |
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 |
-SharedCalendarSyncStartDate
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Observação: esse parâmetro tem suporte apenas para calendários compartilhados que foram atualizados conforme descrito no Compartilhamento de Calendário no Microsoft 365 e não é aplicável a nenhum outro tipo de pasta de calendário ou caixa de correio.
O parâmetro SharedCalendarSyncStartDate especifica o limite para eventos passados no calendário compartilhado que são visíveis para os representantes. Uma cópia do calendário compartilhado no intervalo de datas especificado é armazenada na caixa de correio do representante.
Para especificar um valor de data/hora para este parâmetro, use uma das opções a seguir:
- Especifique o valor de data/hora em UTC: Por exemplo, "2021-05-06 14:30:00z".
- Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local em UTC: Por exemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.
Observações:
- Você usa esse parâmetro no calendário compartilhado na caixa de correio do representante. Por exemplo,
Set-MailboxCalendarFolder -Identity delegate@contoso.onmicrosoft.com:DelegateSharedCalendarFolderId" -SharedCalendarSyncStartDate (Get-Date "5/6/2023 9:30 AM").ToUniversalTime(). DelegateSharedCalendarFolderId é a FolderId do calendário compartilhado na caixa de correio do representante (por exemplo,Get-MailboxFolderStatistics -Identity delegate@contoso.onmicrosoft.com -FolderScope Calendar | Format-List Name,FolderId). - Os usuários precisam ter acesso FullDetails, Editor ou Delegado ao calendário compartilhado especificado.
- A configuração deste parâmetro pode fazer com que os eventos no calendário compartilhado desapareçam brevemente da exibição enquanto o calendário é ressincronizado.
- O valor deste parâmetro é usado ao inicializar a sincronização da pasta calendário. Depois disso, todos os itens novos, atualizados e excluídos são processados e sincronizados, independentemente do valor do parâmetro SharedCalendarSyncStartDate.
Propriedades do parâmetro
| Tipo: | DateTime |
| 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 |
-UseHttps
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção UseHttps especifica se HTTPS deve ser usado para a URL publicada da pasta de calendário. Não é preciso especificar um valor com essa opção.
Essa opção só é significativa quando o valor do parâmetro PublishEnabled é $true.
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 |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
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.