Megosztás a következőn keresztül:

Set-MsolServicePrincipal

  • Referencia
Modul:
MSOnline

Frissíti a szolgáltatásnevet a Microsoft Azure Active Directoryban.

Syntax

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

Description

A Set-MsolServicePrincipal parancsmag frissíti a szolgáltatásnevet a Microsoft Azure Active Directoryban. Használható a megjelenítendő név frissítésére, a szolgáltatásnév engedélyezésére/letiltására, a delegálásra megbízhatóként, a szolgáltatásnévnevekre (SPN-ek) vagy a címekre.

Példák

1. példa: Szolgáltatásnév tulajdonságainak módosítása

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")

Ez a parancs frissíti a megadott szolgáltatásnév tulajdonságait. Ebben a példában a megjelenítendő név és az SPN-k frissítéseit adja meg. Ez felülírja a korábbi beállításokat.

2. példa: Címek módosítása egy szolgáltatásnéven

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

Ez a parancs frissíti egy szolgáltatásnév címét. Ebben a példában a New-MsolServicePrincipalAddresses parancsmaggal korábban létrehozott (myApp1.com, "myApp2.com") címek a szolgáltatásnévhez vannak társítva.

Paraméterek

-AccountEnabled

Ez a tulajdonság jövőbeli használatra van fenntartva.

Típus:Boolean
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-Addresses

Megadja azt a címlistát, amellyel frissíteni és felülírni szeretné a meglévő listát. Ha nem adja meg ezt a paramétert, a meglévő tulajdonság nem frissül. Ha üres listát ad meg, a meglévő címek törlődnek. Használja a New-MsolServicePrincipalAddress parancsmagot a Címek listaobjektum létrehozásához.

Típus:RedirectUri[]
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-AppPrincipalId

Megadja a frissíteni kívánt szolgáltatásnévhez társított egyedi alkalmazásazonosítót.

Típus:Guid
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

Megadja a szolgáltatásnév megjelenítendő nevét.

Típus:String
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

Megadja a frissíteni kívánt szolgáltatásnév egyedi objektumazonosítóját.

Típus:Guid
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalNames

Megadja azoknak az egyszerű szolgáltatásneveknek a listáját, amelyekkel frissíteni és felülírni szeretné a meglévőt. Ha nem adja meg ezt a paramétert, a meglévő tulajdonság nem frissül. Ha üres listát ad meg, a meglévő SPN-k törlődnek, kivéve a szolgáltatásnév AppId értékét tartalmazó egyszerű szolgáltatásnevet. Az SPN-nek az alábbi formátumok egyikét kell használnia:

  • appName
  • appName/hostname
  • érvényes URL-cím
Típus:String[]
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

Megadja annak a bérlőnek az egyedi azonosítóját, amelyen a műveletet végre szeretné hajtani. Az alapértelmezett érték az aktuális felhasználó bérlője. Ez a paraméter csak a partnerfelhasználókra vonatkozik.

Típus:Guid
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False