Partilhar via


New-AzCommunicationServiceKey

Regenere a chave de acesso do CommunicationService. PrimaryKey e SecondaryKey não podem ser regenerados ao mesmo tempo.

Sintaxe

New-AzCommunicationServiceKey
   -CommunicationServiceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-KeyType <KeyType>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzCommunicationServiceKey
   -CommunicationServiceName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Parameter <IRegenerateKeyParameters>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzCommunicationServiceKey
   -InputObject <ICommunicationIdentity>
   [-KeyType <KeyType>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzCommunicationServiceKey
   -InputObject <ICommunicationIdentity>
   -Parameter <IRegenerateKeyParameters>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Regenere a chave de acesso do CommunicationService. PrimaryKey e SecondaryKey não podem ser regenerados ao mesmo tempo.

Exemplos

Exemplo 1: Regenera a chave primária usando uma hashtable IRegenerateKeyParameters

New-AzCommunicationServiceKey -CommunicationServiceName ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Parameter @{KeyType="Primary"}

PrimaryConnectionString              PrimaryKey
-----------------------              ----------
endpoint=<example-primary-endpoint>  <example-primarykey>

Invalida a chave primária anterior, regenera uma nova e devolve-a.

Exemplo 2: Regenera a chave secundária usando um KeyType

New-AzCommunicationServiceKey -CommunicationServiceName ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -KeyType Secondary

SecondaryConnectionString               SecondaryKey
-----------------------                 ----------
endpoint=<example-secondary-endpoint>   <example-secondarykey>

Invalida a chave secundária anterior, regenera uma nova e devolve-a.

Parâmetros

-CommunicationServiceName

O nome do recurso CommunicationService.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:ICommunicationIdentity
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-KeyType

O keyType para regenerar. Deve ser «primário» ou «secundário» (sem distinção entre maiúsculas e minúsculas).

Tipo:KeyType
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Parameter

Parâmetros descreve a solicitação para regenerar chaves de acesso Para construir, consulte a seção NOTAS para propriedades PARAMETER e crie uma tabela de hash.

Tipo:IRegenerateKeyParameters
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SubscriptionId

A ID da assinatura de destino. O valor deve ser um UUID.

Tipo:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

IRegenerateKeyParameters

ICommunicationIdentity

Saídas

ICommunicationServiceKeys