Set-ArcConfig

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-ArcConfig para modificar la lista de selladores de cadena de recepción autenticada (ARC) de confianza configurados en la organización basada en la nube.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Default (valor predeterminado)

Set-ArcConfig
    [-Identity] <HostedConnectionFilterPolicyIdParameter>
    -ArcTrustedSealers <String[]>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Description

Los servicios que modifican el contenido del mensaje en tránsito antes de la entrega pueden invalidar las firmas de correo electrónico DKIM y afectar la autenticación del mensaje. Estos servicios pueden usar ARC para proporcionar detalles de la autenticación original antes de que se produjeran las modificaciones. La organización puede confiar en estos detalles para ayudar a autenticar el mensaje.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Set-ArcConfig -Identity Default -ArcTrustedSealers fabrikam.com

En este ejemplo se configura "fabrikam.com" como el único sellador de ARC de confianza en la organización.

Ejemplo 2

$DomainsAdd = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$DomainsAdd += "cohovineyard.com","tailspintoys.com"

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsAdd

Este ejemplo agrega los selladores ARC de confianza "cohovineyard.com" y "tailspintoys.com" sin afectar a las otras entradas de sellador ARC de confianza.

Ejemplo 3

$x = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$y = $x.Split(",")

$DomainsRemove = [System.Collections.ArrayList]($y)

$DomainsRemove

$DomainsRemove.RemoveAt(6)

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove

Este ejemplo modifica la lista de selladores ARC de confianza eliminando un sellador ARC existente sin afectar a otros selladores ARC que ya están especificados.

Los primeros cuatro comandos devuelven la lista existente de selladores ARC. El primer sellador ARC de la lista tiene el número de índice 0, el segundo tiene el número de índice 1, y así sucesivamente. Use el número de índice para especificar el sellador ARC que desea quitar.

Los dos últimos comandos quitan el séptimo sellador ARC que se muestra en la lista.

Ejemplo 4

$arcSealer = 'fabrikam.com'
$x = @(Get-ArcConfig | Select-Object -Expand ArcTrustedSealers)

$y = @($x.Split(","))
$DomainsRemove = [System.Collections.ArrayList]($y)
$DomainsRemove.Remove($arcSealer)

if ($DomainsToRemove.Count -eq 0) {
   Set-ArcConfig -Identity Default -ArcTrustedSealers " "
   }
else {
   Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove
   }

Este ejemplo elimina el sellador ARC especificado de la lista ($arcSealer).

Si no existen otros selladores ARC después de eliminar esta entrada de la lista, el uso del valor " " del parámetro ArcTrustedSealers evita un error de argumento de enlace si el $DomainsToRemove valor está vacío.

Parámetros

-ArcTrustedSealers

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro ArcTrustedSealers especifica el nombre de dominio de los selladores ARC que desea agregar.

El nombre de dominio debe coincidir con el dominio que se muestra en la d etiqueta de los encabezados ARC-Seal y ARC-Message-Signature en los mensajes de correo electrónico afectados (por ejemplo, fabrikam.com). Puede usar Outlook para ver estos encabezados.

Para reemplazar la lista existente de selladores ARC con los valores que especifique, use la sintaxis Domain1,Domain2,...DomainN. Para conservar los valores existentes, asegúrese de incluir las entradas que desea conservar junto con los nuevos valores que desea agregar.

Para agregar o quitar valores sin afectar a las demás entradas, consulte la sección Ejemplos de este artículo.

Para vaciar la lista, use el valor " " (un espacio entre comillas dobles).

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro Identidad especifica la lista de selladores de ARC de confianza que desea modificar. Use uno de los siguientes valores:

  • Predeterminado para su propia organización.
  • <TenantID\>Default para organizaciones delegadas. El <valor TenantID> es un GUID visible en muchas direcciones URL del portal de administración en Microsoft 365 (el valor tid=). Por ejemplo, a32d39e2-3702-4ff5-9628-31358774c091.

Propiedades de parámetro

Tipo:HostedConnectionFilterPolicyIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.