New-CMCloudManagementGateway

Referência

Módulo:: ConfigurationManager

Criar um gateway de gestão da cloud.

Sintaxe

New-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-Force]
   [-GroupName <String>]
   [-IsUsingExistingGroup <Boolean>]
   [-Region <AzureRegion>]
   -ServiceCertPassword <SecureString>
   -ServiceCertPath <String>
   [-ServiceName <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-SubscriptionId <String>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-Force]
   -GroupName <String>
   [-Region <AzureRegion>]
   -ServerAppClientId <String>
   -ServiceCertPassword <SecureString>
   -ServiceCertPath <String>
   [-ServiceName <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   -SubscriptionId <String>
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para criar um serviço de gateway de gestão da cloud (CMG) no Azure. Para obter mais informações sobre como utilizar este cmdlet para criar um gateway de gestão da cloud (CMG), veja Notas de versão de 2010: Gateway de gestão da cloud.

Para obter mais informações, veja CmG Overview (Descrição Geral do CMG).

A partir da versão 2010, os seguintes parâmetros foram removidos deste cmdlet:

GovernmentSubscription
ManagementCertificatePassword
ManagementCertificatePath
PassThru
RootCertificatePath
ServiceCertificatePassword
ServiceCertificatePath
ServiceCName

Para obter mais informações sobre as outras alterações a este cmdlet na versão 2010, consulte Notas de versão de 2010.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1

$Path = "c:\TestPath\RootCA.cer"
$Type = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA
$Cert =@{$Path = $Type}

$Password = '0HNy*c@63kAe' | ConvertTo-SecureString -AsPlainText -Force

New-CMCloudManagementGateway -ServiceCertPath "c:\TestPath\ServiceCert.pfx" -EnvironmentSetting AzurePublicCloud -SubscriptionId "e517b8cb-a969-4d1e-b2ea-ae1e6c052020" -ServiceCertPassword $Password -ServiceName "GraniteFalls.CloudApp.Net" -Description "EastUS CMG for Contoso" -Region EastUS -VMInstanceCount 2 -CARootCert $Cert -CheckClientCertRevocation $False -EnforceProtocol $True -IsUsingExistingGroup $true -GroupName "Resource group 1"

Exemplo 2

New-CMCloudManagementGateway -ServiceCertPath "c:\TestPath\ServiceCert.pfx" -EnvironmentSetting AzurePublicCloud -SubscriptionId "e517b8cb-a969-4d1e-b2ea-ae1e6c052020" -ServiceCertPassword $Password -ServiceName "GraniteFalls.CloudApp.Net" -Description "EastUS CMG for Contoso" -Region EastUS -VMInstanceCount 2 -CARootCert $Cert -CheckClientCertRevocation $False -EnforceProtocol $True -GroupName "Resource group 1" -EnableCloudDPFunction $true -EnableTrafficOut $true -TrafficOutStopService $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90 -Force

Parâmetros

-CARootCert

Aplica-se à versão 2010 e posterior. Adicione certificados de raiz ao serviço cloud.

Tipo:	Hashtable
Aliases:	CARootCertification, CARootCertifications
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CheckClientCertRevocation

Defina este parâmetro como true para verificar a revogação do certificado de cliente. Uma lista de revogação de certificados (CRL) tem de ser publicada publicamente para que esta verificação funcione. Para obter mais informações, veja Publicar a lista de revogação de certificados.

Tipo:	Boolean
Aliases:	VerifyClientCertificateRevocation
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Description

Uma descrição opcional do CMG, para melhor identificá-lo na consola do Configuration Manager.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableCloudDPFunction

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Permitir que o CMG funcione como um ponto de distribuição na cloud e sirva conteúdos do armazenamento do Azure.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableStorageQuota

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Especificar o limiar de alerta de armazenamento.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableTrafficOut

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Ativar o limiar de 14 dias e alertas para monitorizar a transferência de dados de saída.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnforceProtocol

Aplica-se à versão 2010 e posterior. Ative ou desative a opção para Impor o TLS 1.2.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnvironmentSetting

Especifique o ambiente do Azure para implementar o CMG: na cloud global do Azure (AzurePublicCloud) ou na cloud do Azure Government (AzureUSGovernmentCloud).

Tipo:	AzureEnvironment
Aliases:	AzureEnvironmentOption
Valores aceitos:	AzurePublicCloud, AzureUSGovernmentCloud
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Aplica-se à versão 2010 e posterior. Execute o comando sem pedir confirmação. Se o certificado de serviço contiver vários nomes DNS, utilize este parâmetro para evitar avisos do cmdlet .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-GroupName

Aplica-se à versão 2010 e posterior. Especifique o nome do grupo de recursos do Azure.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IsUsingExistingGroup

Aplica-se à versão 2010 e posterior. Especifique se o grupo de recursos do Azure já existe.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Region

Especifique a região do serviço do Azure, por exemplo: WestUS2.

Tipo:	AzureRegion
Valores aceitos:	EastUS, SouthCentralUS, WestEurope, SoutheastAsia, WestUS2, WestCentralUS
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServerAppClientId

Aplica-se à versão 2010 e posterior. Especifique o ID de cliente da aplicação do servidor Microsoft Entra. Utilize este parâmetro para o modo de interação não utilizador. Nas propriedades do CMG, este valor é o nome da aplicação Microsoft Entra.

Tipo:	String
Aliases:	ServerApplicationClientId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServiceCertPassword

Aplica-se à versão 2010 e posterior. Especifique a palavra-passe do certificado de serviço.

Tipo:	SecureString
Aliases:	ServiceCertificatePassword
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServiceCertPath

Aplica-se à versão 2010 e posterior. Especifique o caminho para o certificado de serviço. Para obter mais informações, veja Certificado de autenticação do servidor CMG.

Tipo:	String
Aliases:	ServiceCertificatePath
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ServiceName

Aplica-se à versão 2010 e posterior. Especifique o nome do serviço do Azure. Se não especificar este parâmetro, o Configuration Manager utiliza o primeiro nome DNS do certificado de serviço. Se o certificado tiver mais do que um nome DNS, utilize este parâmetro para especificar qual utilizar.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageCriticalPct

Aplica-se à versão 2010 e posterior. Especifique um valor inteiro para o alerta Gerar Crítico (% do limiar de alerta de armazenamento). Por exemplo, 90.

Tipo:	Int32
Aliases:	StorageCriticalPercent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageQuotaGB

Aplica-se à versão 2010 e posterior. Especifique um valor inteiro para o limiar de alerta de Armazenamento (GB). Por exemplo, 2.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageWarningPct

Aplica-se à versão 2010 e posterior. Especifique um valor inteiro para o alerta Gerar Aviso (% do limiar de alerta de armazenamento). Por exemplo, 50.

Tipo:	Int32
Aliases:	StorageWarningPercent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SubscriptionId

Especifique o ID da subscrição do Azure onde pretende implementar este novo serviço cloud. O formato deste valor é um GUID padrão.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TenantId

Parâmetro obrigatório onde tenantId tem de ser adicionado durante a criação do cmg.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficCriticalPct

Se ativar alertas para monitorizar a transferência de dados de saída, especifique a percentagem de limiar para gerar um alerta Crítico . Este valor é 90 por predefinição.

Tipo:	Int32
Aliases:	TrafficCriticalPercent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficOutGB

Se ativar os alertas de armazenamento, utilize este parâmetro para especificar o limiar de alerta de armazenamento em GB. O valor padrão é 2.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficOutStopService

Aplica-se à versão 2010 e posterior. Ative ou desative a opção Parar este serviço quando o limiar crítico for excedido.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TrafficWarningPct

Se ativar alertas para monitorizar a transferência de dados de saída, especifique a percentagem de limiar para gerar um alerta de Aviso . Este valor é 50 por predefinição.

Tipo:	Int32
Aliases:	TrafficWarningPercent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-VMInstanceCount

Especifique a contagem de instâncias de máquinas virtuais para o CMG no Azure.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

IResultObject

Compartilhar via