Set-CMCloudManagementGateway

Configurar una puerta de enlace de administración en la nube (CMG).

Syntax

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -InputObject <IResultObject>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Id <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Name <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar una puerta de enlace de administración en la nube (CMG).

Para obtener más información, vea Introducción a CMG.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Cambiar la configuración de alertas de CMG

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableTrafficOut $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90

Ejemplo 2: Cambiar el número de máquinas virtuales para el servicio cmg

Este ejemplo tiene como destino el CMG llamado GraniteFalls y cambia el número de máquinas virtuales a 4 .

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

Ejemplo 3: Habilitar el CMG para que sirva contenido de Azure Storage

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableCloudDPFunction $true

Ejemplo 4: Agregar dos nuevas autoridades de certificación

$path1 = "folder\root.cer"
$type1 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA

$path2 = "folder\intermediate.cer"
$type2 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::IntermediateCA

$cert = @{$path1 = $type1; $path2 = $type2}

Set-CMCloudManagementGateway -Name "GraniteFalls" -CARootCert $cert

Ejemplo 5: Actualizar el certificado de autenticación de servidor cmg

Este ejemplo tiene como destino el CMG denominado GraniteFalls y actualiza el certificado de autenticación de servidor de CMG.

Set-CMCloudManagementGateway -Name "GraniteFalls" -ServiceCertPath "c:\TestPath\NewServiceCert.pfx" -ServiceCertPassword (ConvertTo-SecureString -String "tX*xJ11Nuo^B" -AsPlainText -Force)

Ejemplo 6: Quitar un certificado raíz de un CMG

Set-CMCloudManagementGateway -Name "GraniteFalls" -RemoveCertThumbprints "A7CBA0014DEF847593569D05003D5B96A1D6A627"

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CARootCert

Agregue certificados raíz al servicio en la nube.

Type:Hashtable
Aliases:CARootCertificate, CARootCertificates
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CheckClientCertRevocation

Establezca este parámetro en true para comprobar la revocación de certificados de cliente. Una lista de revocación de certificados (CRL) debe publicarse públicamente para que esta comprobación funcione. Para obtener más información, vea Publish the certificate revocation list.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifique una descripción opcional de este servicio de CMG para identificarlo mejor.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableCloudDPFunction

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción Permitir que CMGfuncione como punto de distribución en la nube y sirva contenido de Azure Storage .

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableStorageQuota

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción especificar el umbral de alerta de almacenamiento.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableTrafficOut

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción activar el umbral de 14 días y las alertas para supervisar la transferencia de datos salientes.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnforceProtocol

Se aplica a la versión 2010 y versiones posteriores. Habilitar o deshabilitar la opción para Aplicar TLS 1.2.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Ejecute el comando sin pedir confirmación. Si el certificado de servicio contiene varios nombres DNS, use este parámetro para evitar advertencias del cmdlet.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifique el identificador del sitio para el servicio de Azure. El identificador es el valor entero almacenado en la base de datos del sitio para el servicio. Por ejemplo, ejecute la siguiente SQL consulta y mire la columna ID: select * from Azure_CloudService .

Type:String
Aliases:AzureServiceId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique un objeto CMG que se debe configurar. Para obtener este objeto, use el cmdlet Get-CMCloudManagementGateway.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifique el nombre del CMG que se debe configurar.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, es posible que este cmdlet no genere ningún resultado.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveCertThumbprints

Se aplica a la versión 2010 y versiones posteriores. Especifique una o más huellas digitales de certificado para quitarlas como autoridades de certificado raíz o intermedia del CMG.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertPassword

Se aplica a la versión 2006 y versiones posteriores. Especifique la contraseña del certificado en -ServiceCertPath.

Type:SecureString
Aliases:ServiceCertificatePassword
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertPath

Se aplica a la versión 2006 y versiones posteriores. Especifique la ruta de acceso al certificado de servicio. Para obtener más información, vea Certificado de autenticación de servidor cmg.

Type:String
Aliases:ServiceCertificatePath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StorageCriticalPct

Se aplica a la versión 2010 y versiones posteriores. Especifique un valor entero para generar alerta crítica (% del umbral de alerta de almacenamiento). Por ejemplo, 90.

Type:Int32
Aliases:StorageCriticalPercent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StorageQuotaGB

Se aplica a la versión 2010 y versiones posteriores. Especifique un valor entero para el Storage de alerta (GB). Por ejemplo, 2.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StorageWarningPct

Se aplica a la versión 2010 y versiones posteriores. Especifique un valor entero para generar alerta de advertencia (% del umbral de alerta de almacenamiento). Por ejemplo, 50.

Type:Int32
Aliases:StorageWarningPercent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TrafficCriticalPct

Si habilita alertas para supervisar la transferencia de datos salientes, especifique el porcentaje de umbral para generar una alerta crítica. Este valor es 90 de forma predeterminada.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TrafficOutGB

Si habilita alertas de almacenamiento, use este parámetro para especificar el umbral de alerta de almacenamiento en GB. El valor predeterminado es 2.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TrafficOutStopService

Se aplica a la versión 2010 y versiones posteriores. Habilite o deshabilite la opción detener este servicio cuando se supereel umbral crítico .

Type:Boolean
Aliases:StopTrafficOutService
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TrafficWarningPct

Si habilita alertas para supervisar la transferencia de datos salientes, especifique el porcentaje de umbral para generar una alerta de advertencia. Este valor es 50 de forma predeterminada.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VMInstanceCount

Se aplica a la versión 2010 y versiones posteriores. Especifique el recuento de instancias de máquinas virtuales.

Type:Int32
Aliases:VMInstancesCount
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object