Udostępnij za pośrednictwem

Remove-AzureRmADSpCredential

  • Odwołanie
Moduł:
AzureRM.Resources

Usuwa poświadczenia z jednostki usługi.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Remove-AzureRmADSpCredential
      -ObjectId <Guid>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalName <String>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADSpCredential
      -ServicePrincipalObject <PSADServicePrincipal>
      [-KeyId <Guid>]
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzureRmADSpCredential może służyć do usunięcia klucza poświadczeń z jednostki usługi w przypadku naruszenia zabezpieczeń lub w ramach wygaśnięcia przerzucania klucza poświadczeń. Jednostka usługi jest identyfikowana przez podanie identyfikatora obiektu lub głównej nazwy usługi (SPN). Poświadczenie do usunięcia jest identyfikowane przez jego identyfikator klucza, jeśli pojedyncze poświadczenie ma zostać usunięte lub z przełącznikiem "Wszystkie" w celu usunięcia wszystkich poświadczeń skojarzonych z jednostką usługi.

Przykłady

Przykład 1 — usuwanie określonego poświadczenia z jednostki usługi

PS C:\> Remove-AzureRmADSpCredential -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 -KeyId 9044423a-60a3-45ac-9ab1-09534157ebb

Usuwa poświadczenia o identyfikatorze klucza "9044423a-60a3-45ac-9ab1-09534157ebb" z jednostki usługi o identyfikatorze obiektu "00001111-aaaa-2222-bbbb-3333cccc4444".

Przykład 2 — usuwanie wszystkich poświadczeń z jednostki usługi

PS C:\> Remove-AzureRmADSpCredential -ServicePrincipalName http://test123

Usuwa wszystkie poświadczenia z jednostki usługi z nazwą SPN "http://test123".

Przykład 3 — usuwanie wszystkich poświadczeń z jednostki usługi przy użyciu potoku

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 00001111-aaaa-2222-bbbb-3333cccc4444 | Remove-AzureRmADSpCredential

Pobiera jednostkę usługi o identyfikatorze obiektu "00001111-aaaa-2222-bbbb-333cc4444" i potokach, które do polecenia cmdlet Remove-AzureRmADSpCredential usunąć wszystkie poświadczenia z tej jednostki usługi.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

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

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

-DisplayName

Nazwa wyświetlana jednostki usługi.

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

-Force

Przełącz się, aby usunąć poświadczenia bez potwierdzenia.

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

-KeyId

Określa klucz poświadczeń do usunięcia. Identyfikatory kluczy dla jednostki usługi można uzyskać przy użyciu polecenia cmdlet Get-AzureRmADSpCredential.

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

-ObjectId

Identyfikator obiektu jednostki usługi w celu usunięcia poświadczeń.

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

-PassThru

Określenie tej wartości spowoduje zwrócenie wartości true, jeśli polecenie zakończyło się pomyślnie.

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

-ServicePrincipalName

Nazwa (SPN) jednostki usługi do usunięcia poświadczeń.

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

-ServicePrincipalObject

Obiekt jednostki usługi w celu usunięcia poświadczeń.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

Guid

String

PSADServicePrincipal

Parametry: ServicePrincipalObject (ByValue)

Dane wyjściowe

Boolean