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 ou outro ambiente.
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.
Syntax
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 informações de publicação de 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 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-MailboxCalendarFolder -Identity kai:\Calendar -DetailLevel LimitedDetailsEste 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 $trueEste exemplo habilita o calendário na caixa de correio de Kai a ser pesquisada na Web.
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 |
-DetailLevel
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:
- DisponibilidadeOnly (esse é o valor padrão)
- LimitedDetails
- FullDetails
- Editor
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
| Type: | DetailLevelEnumType |
| 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 |
-Identity
O parâmetro Identity especifica a pasta de calendário que você deseja modificar. A sintaxe é MailboxID:\ParentFolder[\SubFolder].
Para o valor de MailboxID, você pode usar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domain\username
- 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
| Type: | MailboxFolderIdParameter |
| 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 |
-PublishDateRangeFrom
O parâmetro PublishDateRangeFrom especifica a data de início das informações de calendário a serem publicadas (informações passadas). Os valores válidos são:
- OneDay
- ThreeDays
- OneWeek
- OneMonth
- ThreeMonths (este é o valor padrão)
- SixMonths
- OneYear
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
| Type: | DateRangeEnumType |
| 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 |
-PublishDateRangeTo
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:
- OneDay
- ThreeDays
- OneWeek
- OneMonth
- ThreeMonths (este é o valor padrão)
- SixMonths
- OneYear
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
| Type: | DateRangeEnumType |
| 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 |
-PublishEnabled
O parâmetro PublishEnabled especifica se deve publicar as informações de calendário especificadas. 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 é o valor padrão.
| 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 |
-ResetUrl
A opção ResetUrl substitui a URL não pública existente por uma nova URL para um calendário que foi publicado sem ser pesquisado publicamente. Não é preciso especificar um valor com essa opçã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 |
-SearchableUrlEnabled
O parâmetro SearchableUrlEnabled especifica se a URL de calendário publicada é detectável na Web.
- $true: a URL de calendário publicada é detectável na Web.
- $false: a URL do calendário publicado não é detectável na Web. Esse é o valor padrão.
Esse parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
| 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 |
-SetAsSharingSource
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SharedCalendarSyncStartDate
Esse parâmetro só está disponível no serviço baseado em nuvem.
Observação: esse parâmetro só tem suporte 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 delegados. Uma cópia do calendário compartilhado dentro do intervalo de datas especificado é armazenada na caixa de correio do delegado.
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 delegado. Por exemplo,
Set-MailboxCalendarFolder -Identity delegate@contoso.onmicrosoft.com:DelegateSharedCalendarFolderId" -SharedCalendarSyncStartDate (Get-Date "5/6/2023 9:30 AM").ToUniversalTime(). DelegateSharedCalendarFolderId é o FolderId do calendário compartilhado na caixa de correio do delegado (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 desse parâmetro pode fazer com que os eventos no calendário compartilhado desapareçam brevemente do modo de exibição enquanto o calendário é ressincronizado.
- O valor desse parâmetro é usado ao inicializar a sincronização da pasta de calendário. Depois disso, cada item novo, atualizado e excluído é processado e sincronizado, independentemente do valor do parâmetro SharedCalendarSyncStartDate.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UseHttps
A opção UseHttps especifica se deve usar HTTPS para a URL publicada da pasta 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de