Udostępnij za pośrednictwem

Set-MsolServicePrincipal

  • Odwołanie
Moduł:
MSOnline

Aktualizuje jednostkę usługi w usłudze Microsoft Azure Active Directory.

Składnia

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-MsolServicePrincipal aktualizuje jednostkę usługi w usłudze Microsoft Azure Active Directory. Może służyć do aktualizowania nazwy wyświetlanej, włączania/wyłączania jednostki usługi, zaufanej dla delegowania, głównych nazw usługi (SPN) lub adresów.

Przykłady

Przykład 1. Zmienianie właściwości jednostki usługi

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

To polecenie aktualizuje właściwości określonej jednostki usługi. W tym przykładzie określa aktualizacje nazwy wyświetlanej i nazwy SPN. Spowoduje to zastąpienie wszystkich poprzednich ustawień.

Przykład 2. Zmienianie adresów w jednostce usługi

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

To polecenie aktualizuje adresy jednostki usługi. W tym przykładzie istniejące adresy, które zostały wcześniej utworzone ("myApp1.com", "myApp2.com") przy użyciu polecenia cmdlet New-MsolServicePrincipalAddresses , są skojarzone z jednostką usługi.

Parametry

-AccountEnabled

Ta właściwość jest zarezerwowana do użytku w przyszłości.

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

-Addresses

Określa listę adresów, za pomocą której ma być aktualizowana i zastępowana istniejąca lista. Jeśli nie określisz tego parametru, istniejąca właściwość nie zostanie zaktualizowana. Jeśli określisz pustą listę, istniejące adresy zostaną wyczyszczone. Użyj polecenia cmdlet New-MsolServicePrincipalAddress , aby ułatwić tworzenie obiektu listy Adresy.

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

-AppPrincipalId

Określa unikatowy identyfikator aplikacji skojarzony z jednostką usługi do zaktualizowania.

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

-DisplayName

Określa nazwę wyświetlaną jednostki usługi.

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

-ObjectId

Określa unikatowy identyfikator obiektu jednostki usługi do zaktualizowania.

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

-ServicePrincipalNames

Określa listę nazw SPN, z którymi ma być aktualizowana i zastępowana istniejąca. Jeśli nie określisz tego parametru, istniejąca właściwość nie zostanie zaktualizowana. Jeśli określisz pustą listę, istniejące nazwy SPN zostaną wyczyszczone, z wyjątkiem nazwy SPN zawierającej wartość AppId jednostki usługi. Nazwa SPN musi używać jednego z następujących formatów:

  • appName
  • appName/hostname
  • prawidłowy adres URL
Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TenantId

Określa unikatowy identyfikator dzierżawy, na którym ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr dotyczy tylko użytkowników partnerów.

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