Udostępnij za pośrednictwem

Set-AzureADMSServicePrincipal

  • Odwołanie
Moduł:
AzureADPreview

Aktualizuje jednostkę usługi.

Składnia

Set-AzureADMSServicePrincipal
   -Id <String>
   [-AccountEnabled <String>]
   [-AppId <String>]
   [-AppRoleAssignmentRequired <Boolean>]
   [-CustomSecurityAttributes <Object>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-LogoutUrl <String>]
   [-Homepage <String>]
   [-SamlMetadataUrl <String>]
   [-MicrosoftFirstParty <Boolean>]
   [-PublisherName <String>]
   [-PreferredTokenSigningKeyThumbprint <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsKeyCredential]>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.MsPasswordCredential]>]
   [<CommonParameters>]

Opis

Aktualizuje jednostkę usługi w usłudze Azure Active Directory (Azure AD).

Przykłady

Przykład 1

PS C:\> Set-AzureADMSServicePrincipal -Id 2e0d8ca7-57d1-4a87-9c2a-b3638a4cadbf -AccountEnabled $False

To polecenie wyłącza konto określonej jednostki usługi.

Przykład 2

PS C:\> $attributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Baker","Cascade")
    }
}
PS C:\> Set-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20 -CustomSecurityAttributes $attributes

Przypisz niestandardowy atrybut zabezpieczeń z wartością wielociągową do aplikacji (jednostki usługi).

  • Zestaw atrybutów: Engineering
  • Atrybut: Project
  • Typ danych atrybutu: kolekcja ciągów
  • Wartość atrybutu: ("Baker","Cascade")

Przykład 3

PS C:\> $attributesUpdate = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Alpine","Baker")
    }
}
PS C:\> Set-AzureADMSServicePrincipal -Id 7d194b0c-bf17-40ff-9f7f-4b671de8dc20 -CustomSecurityAttributes $attributesUpdate

Zaktualizuj niestandardowy atrybut zabezpieczeń z wartością wielociągową dla aplikacji (jednostki usługi).

  • Zestaw atrybutów: Engineering
  • Atrybut: Project
  • Typ danych atrybutu: kolekcja ciągów
  • Wartość atrybutu: ("Alpine","Baker")

Parametry

-AccountEnabled

Wskazuje, czy konto jest włączone.

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

-AppId

Określa identyfikator aplikacji.

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

-AppRoleAssignmentRequired

Wskazuje, czy przypisanie roli aplikacji jest wymagane.

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

-CustomSecurityAttributes

Niestandardowe atrybuty zabezpieczeń dla jednostki usługi.

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

-DisplayName

Określa nazwę wyświetlaną.

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

-ErrorUrl

Określa adres URL błędu.

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

-Homepage

Określa stronę główną.

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

-Id

Określa identyfikator jednostki usługi w usłudze Azure AD.

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

-KeyCredentials

Określa poświadczenia klucza.

Typ:List<T>[Microsoft.Open.MSGraph.Model.MsKeyCredential]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogoutUrl

Określa adres URL wylogowywania.

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

-MicrosoftFirstParty

Wskazuje, czy jednostka usługi jest przeznaczona dla aplikacji pierwszej firmy Microsoft.

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

-PasswordCredentials

Określa poświadczenia hasła.

Typ:List<T>[Microsoft.Open.MSGraph.Model.MsPasswordCredential]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PreferredTokenSigningKeyThumbprint

Preferowany odcisk palca klucza podpisywania tokenu dla jednostki usługi.

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

-PublisherName

Określa nazwę wydawcy.

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

-ReplyUrls

Adresy URL, do których są wysyłane tokeny użytkownika w celu logowania się do skojarzonej aplikacji lub identyfikatory URI przekierowania, do których są wysyłane kody autoryzacji protokołu OAuth 2.0 i tokeny dostępu dla skojarzonej aplikacji.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SamlMetadataUrl

@{Text=}

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

-ServicePrincipalNames

Określa nazwy główne usługi.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tags

Określa tablicę tagów. Pamiętaj, że jeśli ta jednostka usługi ma być wyświetlana na liście Wszystkie aplikacje w portalu administracyjnym, musisz ustawić tę wartość na {WindowsAzureActiveDirectoryIntegratedApp}

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

Object