Udostępnij za pośrednictwem

Get-AzKeyVaultManagedHsm

  • Odwołanie
Moduł:
Az.KeyVault

Pobieranie zarządzanych modułów HSM.

Składnia

Get-AzKeyVaultManagedHsm
   [[-Name] <String>]
   [[-ResourceGroupName] <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]
Get-AzKeyVaultManagedHsm
   [-Name] <String>
   [-Location] <String>
   [-InRemovedState]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]
Get-AzKeyVaultManagedHsm
   [-InRemovedState]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzKeyVaultManagedHsm pobiera informacje o zarządzanych modułach HSM w subskrypcji. Wszystkie wystąpienia zarządzanego modułu HSM można wyświetlić w ramach subskrypcji lub filtrować wyniki według grupy zasobów lub określonego zarządzanego modułu HSM. Należy pamiętać, że chociaż określenie grupy zasobów jest opcjonalne dla tego polecenia cmdlet po otrzymaniu pojedynczego zarządzanego modułu HSM, należy to zrobić, aby uzyskać lepszą wydajność.

Przykłady

Przykład 1. Pobieranie wszystkich zarządzanych modułów HSM w bieżącej subskrypcji

Get-AzKeyVaultManagedHsm

Name    Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----    ------------------- -------- ---        ----------------- --------------------------------
myhsm   test-rg              eastus   StandardB1 Succeeded         Active

To polecenie pobiera wszystkie zarządzane moduły HSM w bieżącej subskrypcji.

Przykład 2. Pobieranie określonego zarządzanego modułu HSM

Get-AzKeyVaultManagedHsm -Name 'myhsm'

Name    Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----    ------------------- -------- ---        ----------------- --------------------------------
myhsm   test-rg              eastus   StandardB1 Succeeded         Active

To polecenie pobiera zarządzany moduł HSM o nazwie myhsm w bieżącej subskrypcji.

Przykład 3. Pobieranie zarządzanych modułów HSM w grupie zasobów

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

Name  Resource Group Name Location    SKU        ProvisioningState Security Domain ActivationStatus
----  ------------------- --------    ---        ----------------- --------------------------------
myhsm myrg1               eastus2euap StandardB1 Succeeded         Active

To polecenie pobiera wszystkie zarządzane moduły HSM w grupie zasobów o nazwie myrg1.

Przykład 4. Pobieranie zarządzanych modułów HSM przy użyciu filtrowania

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

Name  Resource Group Name Location    SKU        ProvisioningState Security Domain ActivationStatus
----  ------------------- --------    ---        ----------------- --------------------------------
myhsm myrg1               eastus2euap StandardB1 Succeeded         Active

To polecenie pobiera wszystkie zarządzane moduły HSM w subskrypcji rozpoczynającej się od "myhsm".

Przykład 5. Wyświetlanie listy usuniętych zarządzanych modułów HSM

Get-AzKeyVaultManagedHsm -InRemovedState

Name                     Location      DeletionDate           ScheduledPurgeDate    Purge Protection Enabled?
----                     --------      ------------           ------------------    -------------------------
xxxxxxxx-mhsm-4op2n2g4xe eastus2       12/30/2021 2:29:00 AM  3/30/2022 2:29:00 AM  True
xxxxxxx-mhsm-ertopo7tnxa westus        12/29/2021 11:48:42 PM 3/29/2022 11:48:42 PM True
xxxxxxx-mhsm-gg66fgctz67 westus        12/29/2021 11:48:42 PM 3/29/2022 11:48:42 PM False
xxxxxxx-mhsm-2m5jiop6mfo westcentralus 12/30/2021 12:26:14 AM 3/30/2022 12:26:14 AM True

To polecenie pobiera wszystkie zarządzane moduły HSM w bieżącej subskrypcji.

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InRemovedState

Określa, czy w danych wyjściowych ma być wyświetlana wcześniej usunięta zarządzana pula modułów HSM.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Lokalizacja usuniętej zarządzanej puli modułów HSM.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa modułu HSM. Polecenie cmdlet konstruuje nazwę FQDN modułu HSM na podstawie nazwy i aktualnie wybranego środowiska.

Typ:String
Aliasy:HsmName
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-ResourceGroupName

Określa nazwę grupy zasobów skojarzonej z zarządzanym modułem HSM, którego dotyczy zapytanie.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-SubscriptionId

Identyfikator subskrypcji. Domyślnie polecenia cmdlet są wykonywane w subskrypcji ustawionej w bieżącym kontekście. Jeśli użytkownik określi inną subskrypcję, bieżące polecenie cmdlet zostanie wykonane w subskrypcji określonej przez użytkownika. Zastępowanie subskrypcji ma zastosowanie tylko w cyklu życia bieżącego polecenia cmdlet. Nie zmienia subskrypcji w kontekście i nie ma wpływu na kolejne polecenia cmdlet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Określa klucz i opcjonalną wartość określonego tagu, aby filtrować listę zarządzanych modułów HSM według.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Hashtable

Dane wyjściowe

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem