New-SBNamespace
Letzte Aktualisierung: April 2013
New-SBNamespace
Diese Cmdlet erstellt einen neuen Service Bus for Windows Server-Dienstnamespaceeintrag in der Service Bus for Windows-Serverfarm.
Syntax
Parameter Set: Default
New-SBNamespace -ManageUsers <String[]> -Name <String> [-AddressingScheme <NamespaceFormat> ] [-DnsEntry <String> ] [-IssuerName <String> ] [-IssuerUri <String> ] [-PrimarySymmetricKey <String> ] [-SecondarySymmetricKey <String> ] [-SubscriptionId <Guid> ] [ <CommonParameters>]
Detaillierte Beschreibung
Führen Sie "New-SBNamespace" aus, um einen neuen Service Bus for Windows Server-Dienstnamespace zu erstellen.
Ein Service Bus for Windows Server-Dienstnamespace verhält sich wie eine Bereichsentität für Service Bus for Windows Server-Warteschlangen und -Themen und stellt eine Isolierung zwischen mehreren Anwendungen (Mandanten) zur Verfügung. Wenn Service Bus for Windows Server-Entitäten (Warteschlangen oder Themen) erstellt werden, ist der Name des Service Bus for Windows Server-Dienstnamespaces erforderlich. Er legt das Adressierungsschema sowie das URI-Präfix für alle Entitäten fest.
Ein Service Bus for Windows Server-Dienstnamespace kann einem der folgenden Adressierungsschemas folgen:
1. Der pfadbasierte Dienstnamespace (Standardwert) verwendet den FQDN der Service Bus for Windows Server-Hosts als Präfix des Dienstnamespacenamens.
2. Der Pfad mit der Dienst-ID wird bei der Freigabe eines Ports verwendet. Für dieses Adressierungsschema ist ein ServiceId-Parameter zusätzlich zu den obligatorischen Parametern erforderlich.
3. Der DNSRegistered-Dienstnamespace wird verwendet, wenn Sie Ihren Dienstnamespace bei einer Namenvergebungsstelle (z. B. DNS) registrieren. Für dieses Adressierungsschema ist ein URI zusätzlich zu den obligatorischen Parametern erforderlich.
Die Parameter "IssuerName", "IssuerUri", "PrimarySymmetricKey" und "SecondarySymmetricKey" sind alle optional.
Parameter
-AddressingScheme<NamespaceFormat>
Gibt das im Dienstnamespace verwendete Adressierungsschema an. Die folgenden Werte sind für diesen Parameter möglich: Path (Standardwert) und DNSRegistered. Wenn der Wert DNSRegistered angegeben wird, ist der -DnsEntry -Parameter erforderlich.
Aliase |
scheme |
Erforderlich? |
false |
Position? |
named |
Standardwert |
NamespaceFormat.Path |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-DnsEntry<String>
Gibt den DNS-Eintrag an.
Aliase |
keine |
Erforderlich? |
false |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-IssuerName<String>
Gibt den Namen des vertrauenswürdigen Sicherheitsausstellers an.
Aliase |
keine |
Erforderlich? |
false |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-IssuerUri<String>
Gibt einen Aussteller-URI an, für den zwischen Groß- und Kleinschreibung unterschieden wird.
Aliase |
keine |
Erforderlich? |
false |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-ManageUsers<String[]>
Gibt Benutzer- oder Gruppennamen an, die Manager des Dienstnamespaces sind.
Aliase |
manage |
Erforderlich? |
true |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Name<String>
Gibt den Namen für den neuen Service Bus for Windows Server-Dienstnamespace an.
Aliase |
n |
Erforderlich? |
true |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-PrimarySymmetricKey<String>
Gibt den primären Schlüssel an, der in diesem Dienstnamespace verwendet werden soll.
Aliase |
primary |
Erforderlich? |
false |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-SecondarySymmetricKey<String>
Gibt den sekundären Schlüssel an, der in diesem Dienstnamespace verwendet werden soll.
Aliase |
secondary |
Erforderlich? |
false |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-SubscriptionId<Guid>
Ein optionaler Parameter, der einen Namespace einem Abonnement zuordnet. Dieser Parameter ist beispielsweise sinnvoll, wenn ein Administrator einen Namespace für einen Benutzer erstellt.
Aliase |
keine |
Erforderlich? |
false |
Position? |
named |
Standardwert |
keine |
Pipelineeingaben akzeptieren? |
True (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
Beispiele
Beispiel 1
Erstellt einen Service Bus for Windows Server-Dienstnamespace mit dem Namen "MyNamespace1" und weist diesem "user1" als Besitzer zu.
PS C:\> New-SBNamespace -Name MyNamespace1 -ManageUsers user1@domain1