Share via

Set-MsolServicePrincipal

  • Odwołanie
Moduł:
MSOnline

Aktualizacje jednostkę usługi w 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 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. Zmiana 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 nazw SPN. Spowoduje to zastąpienie wszystkich poprzednich ustawień.

Przykład 2: Zmiana 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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Addresses

Określa listę adresów, z którą należy zaktualizować i zastąpić istniejącą listę. 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ć utworzenie obiektu listy Adresy.

Type:RedirectUri[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AppPrincipalId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False