Share via

Set-MsolServicePrincipal

  • Reference
Modul:
MSOnline

Aktualizace instanční objekt v Microsoft Azure Active Directory.

Syntax

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

Description

Rutina Set-MsolServicePrincipal aktualizuje instanční objekt v Microsoft Azure Active Directory. Dá se použít k aktualizaci zobrazovaného názvu, povolení nebo zakázání instančního objektu, důvěryhodného pro delegování, hlavních názvů služby (SPN) nebo adres.

Příklady

Příklad 1: Změna vlastností instančního objektu

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

Tento příkaz aktualizuje vlastnosti zadaného instančního objektu. V tomto příkladu určuje aktualizace zobrazovaného názvu a hlavních názvů služeb. Tím se přepíše všechna předchozí nastavení.

Příklad 2: Změna adres v instančním objektu

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

Tento příkaz aktualizuje adresy instančního objektu. V tomto příkladu jsou existující adresy, které byly dříve vytvořeny ("myApp1.com", "myApp2.com") pomocí rutiny New-MsolServicePrincipalAddresses , přidruženy k instančnímu objektu.

Parametry

-AccountEnabled

Tato vlastnost je vyhrazena pro budoucí použití.

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

-Addresses

Určuje seznam adres, pomocí kterého se má existující seznam aktualizovat a přepsat. Pokud tento parametr nezadáte, stávající vlastnost se neaktualizuje. Pokud zadáte prázdný seznam, stávající adresy se vymažou. K vytvoření objektu Addresses list použijte rutinu New-MsolServicePrincipalAddress .

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

-AppPrincipalId

Určuje jedinečné ID aplikace přidružené k instančnímu objektu, který se má aktualizovat.

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

-DisplayName

Určuje zobrazovaný název instančního objektu.

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

-ObjectId

Určuje jedinečné ID objektu instančního objektu, který se má aktualizovat.

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

-ServicePrincipalNames

Určuje seznam hlavních názvů služby (SPN), pomocí kterých se má aktualizovat a přepsat existující. Pokud tento parametr nezadáte, stávající vlastnost se neaktualizuje. Pokud zadáte prázdný seznam, stávající hlavní názvy služeb se vymažou s výjimkou hlavního názvu služby, který obsahuje hodnotu AppId instančního objektu. Hlavní název služby (SPN) musí používat jeden z následujících formátů:

  • appName
  • appName/hostname
  • platná adresa URL
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

Určuje jedinečné ID tenanta, na kterém se má operace provést. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr se vztahuje pouze na uživatele partnera.

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