Partilhar via


Test-AzKeyVaultManagedHsmNameAvailability

Verifica se o nome hsm gerenciado é válido e ainda não está em uso.

Sintaxe

Test-AzKeyVaultManagedHsmNameAvailability
    [-SubscriptionId <String>]
    -Name <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-AzKeyVaultManagedHsmNameAvailability
    [-SubscriptionId <String>]
    -JsonFilePath <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-AzKeyVaultManagedHsmNameAvailability
    [-SubscriptionId <String>]
    -JsonString <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Verifica se o nome hsm gerenciado é válido e ainda não está em uso.

Exemplos

Exemplo 1: Testar a disponibilidade de um nome HSM não utilizado

Test-AzKeyVaultManagedHsmNameAvailability -Name testmhsm0818

Message NameAvailable Reason
------- ------------- ------
                 True

Este comando testa a disponibilidade do nome testmhsm0818do vault . Os resultados mostram testmhsm0818 que não está ocupado.

Exemplo 2: Testar a disponibilidade de um nome HSM usado

Test-AzKeyVaultNameAvailability -Name testmhsm

Message                               NameAvailable Reason
-------                               ------------- ------
The name 'testmhsm' is already in use.         False AlreadyExists

Este comando testa a disponibilidade do nome testmhsmdo HSM. Os resultados mostram testmhsm que já está em uso.

Parâmetros

-Confirm

Solicita a sua 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

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Check

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

-JsonString

String Json fornecida para a operação Check

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

-Name

O nome hsm gerenciado.

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

-SubscriptionId

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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

Saídas

ICheckMhsmNameAvailabilityResult