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.