Udostępnij za pośrednictwem


Clear-AzureRemoteAppVmStaleAdObject

Usuwa obiekty w identyfikatorze Entra firmy Microsoft skojarzonym z maszynami wirtualnymi usługi Azure RemoteApp, które już nie istnieją.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

Clear-AzureRemoteAppVmStaleAdObject
     -CollectionName <String>
     [-Credential <PSCredential>]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Opis

Polecenie cmdlet Clear-AzureRemoteAppVmStaleAdObject usuwa obiekty w identyfikatorze Entra firmy Microsoft skojarzonym z maszynami wirtualnymi usługi Azure RemoteApp, które już nie istnieją. Należy użyć poświadczeń, które mają prawa do usuwania obiektów Entra firmy Microsoft. Jeśli określisz typowy parametr Verbose , to polecenie cmdlet wyświetli nazwę każdego obiektu, który zostanie usunięty.

Przykłady

Przykład 1. Czyszczenie nieaktualnych obiektów dla kolekcji

PS C:\> $AdminCredentials = Get-Credential
PS C:\> Clear-AzureRemoteAppVmStaleAdObject -CollectionName "Contoso" -Credential $AdminCredentials

Pierwsze polecenie wyświetla monit o podanie nazwy użytkownika i hasła przy użyciu polecenia Get-Credential. Polecenie przechowuje wyniki w zmiennej $AdminCredentials.

Drugie polecenie czyści nieaktualne obiekty kolekcji o nazwie Contoso. Polecenie używa poświadczeń przechowywanych w zmiennej $AdminCredentials. Aby polecenie powiodło się, te poświadczenia muszą mieć odpowiednie prawa.

Parametry

-CollectionName

Określa nazwę kolekcji usługi Azure RemoteApp.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Określa poświadczenie, które ma prawa do wykonania tej akcji. Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential . Jeśli nie określisz tego parametru, to polecenie cmdlet używa bieżących poświadczeń użytkownika.

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

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
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ść:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False